hwnclx.h-Header

  • Artikel

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.