Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Header definiert Programmierschnittstellen, die erforderlich sind, um hardwareunabhängige Unterstützung von Benachrichtigungskomponenten wie LEDs und Vibrationsmechanismen bereitzustellen. Diese Unterstützung wird durch die Einführung einer Kernel-Mode Driver Framework (KMDF)-Klassenerweiterung speziell für Hardwarebenachrichtigungskomponenten bereitgestellt, die die 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 wie ein Porttreiber im Windows-Treibermodell (WDM). Dieser Abschnitt enthält eine Übersicht über die Architektur der Hardwarebenachrichtigungsklassenerweiterung. Weitere Informationen zur KMDF finden Sie unter
Weitere Informationen finden Sie unter:
- Entwurfshandbuch für Hardwarebenachrichtigungen
hwnclx.h enthält die folgenden Programmierschnittstellen:
Funktionen
|
HwNProcessAddDevicePostDeviceCreate Erstellt E/A-Warteschlangen. Sie sollte aufgerufen werden, nachdem die EVT_WDF_DRIVER_DEVICE_ADD Rückruffunktion des Clienttreibers aufgerufen wurde und das Geräteobjekt erstellt wurde. |
|
HwNProcessAddDevicePreDeviceCreate Stellt die Geräterückrufe für die Vorbereitung/Veröffentlichung und den Ein- und Ausstieg an die Windows Driver Foundation (WDF) bereit, um das Gerät in verschiedene Zustände zu übertragen. |
|
HwNRegisterClient- Registriert den Hardwarebenachrichtigungsclienttreiber und seine Rückruffunktionen mit der Klassenerweiterung. |
|
HwNUnregisterClient- Hebt die Registrierung des Hardwarebenachrichtigungsclienttreibers und der zugehörigen Rückruffunktionen mit der Klassenerweiterung auf. Diese Funktion sollte aufgerufen werden, wenn der Clienttreiber entladen wird. |
Rückruffunktionen
|
HWN_CLIENT_GET_STATE Vom Clienttreiber implementiert, um den Hardwarebenachrichtigungskomponentenstatus abzurufen. Er wird aufgerufen, wenn ein Benutzer Statusinformationen 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 Implementiert vom Clienttreiber zum Abrufen von Hardwarebenachrichtigungskomponentenattributen. |
|
HWN_CLIENT_SET_STATE Vom Clienttreiber implementiert, um den Hardwarebenachrichtigungskomponentenstatus festzulegen. Er wird aufgerufen, wenn ein Benutzer den Zustand eines Treibers ändern möchte. |
|
HWN_CLIENT_START_DEVICE 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 nicht initialisiert. |
Strukturen
|
CLIENT_DEVICE_INFORMATION Die CLIENT_DEVICE_INFORMATION Struktur wird vom Hardwarebenachrichtigungsrückruf HWN_CLIENT_QUERY_DEVICE_INFORMATION verwendet, um die Gesamtanzahl 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 jede der Hardwarebenachrichtigungsexporte in der Exporttabelle. |