platform/x86: wmi: Update WMI driver API documentation

The WMI driver core now passes the WMI event data to legacy notify
handlers, so WMI devices sharing notification IDs are now being
handled properly.

Fixes: e04e2b760ddb ("platform/x86: wmi: Pass event data directly to legacy notify handlers")
Signed-off-by: Armin Wolf <W_Armin@gmx.de>
Link: https://lore.kernel.org/r/20241005213825.701887-1-W_Armin@gmx.de
Signed-off-by: Hans de Goede <hdegoede@redhat.com>

authored by Armin Wolf and committed by Hans de Goede 5984b40f 7b954b9b

Changed files
+5 -6
Documentation
driver-api
+5 -6
Documentation/driver-api/wmi.rst
··· 7 7 The WMI driver core supports a more modern bus-based interface for interacting 8 8 with WMI devices, and an older GUID-based interface. The latter interface is 9 9 considered to be deprecated, so new WMI drivers should generally avoid it since 10 - it has some issues with multiple WMI devices and events sharing the same GUIDs 11 - and/or notification IDs. The modern bus-based interface instead maps each 12 - WMI device to a :c:type:`struct wmi_device <wmi_device>`, so it supports 13 - WMI devices sharing GUIDs and/or notification IDs. Drivers can then register 14 - a :c:type:`struct wmi_driver <wmi_driver>`, which will be bound to compatible 15 - WMI devices by the driver core. 10 + it has some issues with multiple WMI devices sharing the same GUID. 11 + The modern bus-based interface instead maps each WMI device to a 12 + :c:type:`struct wmi_device <wmi_device>`, so it supports WMI devices sharing the 13 + same GUID. Drivers can then register a :c:type:`struct wmi_driver <wmi_driver>` 14 + which will be bound to compatible WMI devices by the driver core. 16 15 17 16 .. kernel-doc:: include/linux/wmi.h 18 17 :internal: