2023-04-25 00:29:38 +02:00
|
|
|
.. SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
|
|
|
|
==============
|
|
|
|
WMI Driver API
|
|
|
|
==============
|
|
|
|
|
|
|
|
The WMI driver core supports a more modern bus-based interface for interacting
|
|
|
|
with WMI devices, and an older GUID-based interface. The latter interface is
|
|
|
|
considered to be deprecated, so new WMI drivers should generally avoid it since
|
2024-10-05 23:38:24 +02:00
|
|
|
it has some issues with multiple WMI devices sharing the same GUID.
|
|
|
|
The modern bus-based interface instead maps each WMI device to a
|
|
|
|
:c:type:`struct wmi_device <wmi_device>`, so it supports WMI devices sharing the
|
|
|
|
same GUID. Drivers can then register a :c:type:`struct wmi_driver <wmi_driver>`
|
|
|
|
which will be bound to compatible WMI devices by the driver core.
|
2023-04-25 00:29:38 +02:00
|
|
|
|
|
|
|
.. kernel-doc:: include/linux/wmi.h
|
|
|
|
:internal:
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/platform/x86/wmi.c
|
|
|
|
:export:
|