hwnclx.h-Header
Dieser Header definiert Programmierschnittstellen, die für die hardwareunabhängige Unterstützung von Benachrichtigungskomponenten wie LEDs und Schwingungsmechanismen erforderlich sind. Diese Unterstützung wird durch die Einführung einer KMDF-Klassenerweiterung (Kernel-Mode Driver Framework) speziell für Hardwarebenachrichtigungskomponenten bereitgestellt, die eine schnelle Entwicklung von Clienttreibern ermöglichen. Eine KMDF-Klassenerweiterung ist im Wesentlichen ein KMDF-Treiber, der einen definierten Satz von Funktionen für eine bestimmte Geräteklasse bereitstellt, ähnlich einem Porttreiber im Windows-Treibermodell (WDM). Dieser Abschnitt bietet eine Übersicht über die Architektur der Hardwarebenachrichtigungsklassenerweiterung. Weitere Informationen zur KMDF finden Sie unter
Weitere Informationen finden Sie unter
hwnclx.h enthält die folgenden Programmierschnittstellen:
Functions
|
HwNProcessAddDevicePostDeviceCreate Erstellt E/A-Warteschlangen. Sie sollte aufgerufen werden, nachdem die EVT_WDF_DRIVER_DEVICE_ADD Rückruffunktion des Clienttreibers aufgerufen und das Geräteobjekt erstellt wurde. |
|
HwNProcessAddDevicePreDeviceCreate Stellt die Gerätevorbereitungs-,Freigabe- und Ein-/Ausstiegsrückrufe an die Windows Driver Foundation (WDF) bereit, um das Gerät in verschiedene Zustände zu übergehen. |
|
HwNRegisterClient Registriert den Hardwarebenachrichtigungsclienttreiber und die zugehörigen Rückruffunktionen bei der Klassenerweiterung. |
|
HwNUnregisterClient Hebt die Registrierung des Hardwarebenachrichtigungsclienttreibers und seiner Rückruffunktionen mit der Klassenerweiterung auf. Diese Funktion sollte aufgerufen werden, wenn der Clienttreiber entladen wird. |
Rückruffunktionen
|
HWN_CLIENT_GET_STATE Wird vom Clienttreiber implementiert, um den Zustand der Hardwarebenachrichtigungskomponente abzurufen. Sie wird aufgerufen, wenn ein Benutzer status Informationen anfordert. |
|
HWN_CLIENT_INITIALIZE_DEVICE Wird vom Clienttreiber implementiert und als Ergebnis eines Aufrufs von EVT_WDF_DEVICE_PREPARE_HARDWARE aufgerufen. |
|
HWN_CLIENT_QUERY_DEVICE_INFORMATION Wird vom Clienttreiber implementiert, um Hardwarebenachrichtigungskomponentenattribute abzurufen. |
|
HWN_CLIENT_SET_STATE Wird vom Clienttreiber implementiert, um den Zustand der Hardwarebenachrichtigungskomponente festzulegen. Sie wird aufgerufen, wenn ein Benutzer den Zustand eines Treibers ändern möchte. |
|
HWN_CLIENT_START_DEVICE Wird vom Clienttreiber implementiert, um die Hardwarebenachrichtigungskomponente zu starten. Sie wird als Ergebnis eines Aufrufs von EVT_WDF_DEVICE_D0_ENTRY aufgerufen. |
|
HWN_CLIENT_STOP_DEVICE Vom Clienttreiber implementiert, UM die Hardwarebenachrichtigungskomponente zu starten. Sie wird als Ergebnis eines Aufrufs von EVT_WDF_DEVICE_D0_EXIT aufgerufen. |
|
HWN_CLIENT_UNINITIALIZE_DEVICE Wird vom Clienttreiber implementiert und als Ergebnis eines Aufrufs von EVT_WDF_DEVICE_RELEASE_HARDWARE aufgerufen. Mit dieser Rückruffunktion wird die Hardwarebenachrichtigungskomponente initialisiert. |
Strukturen
|
CLIENT_DEVICE_INFORMATION Die CLIENT_DEVICE_INFORMATION-Struktur wird vom Hardwarebenachrichtigungsrückruf HWN_CLIENT_QUERY_DEVICE_INFORMATION verwendet, um die Gesamtzahl der Hardwarebenachrichtigungen zurückzugeben, die der Clientgerätetreiber bereitstellt. |
|
HWN_CLIENT_REGISTRATION_PACKET Hardwarebenachrichtigungs-Clienttreiberregistrierungspaket, das an die Klassenerweiterung übergeben wird, wenn ein Clienttreiber registriert wird. Enthält Versionsinformationen und Clienttreiberrückruffunktionen. |
Enumerationen
|
HWN_CLX_EXPORT_INDEX Definiert die Position für die einzelnen Hardwarebenachrichtigungsexporte in der Exporttabelle. |