GPIO_CLX_RegisterClient-Funktion (gpioclx.h)
Die GPIO_CLX_RegisterClient-Methode registriert einen GPIO-Controllertreiber (General Purpose E/O) als Client der GPIO-Frameworkerweiterung (GpioClx).
Syntax
NTSTATUS GPIO_CLX_RegisterClient(
[in] WDFDRIVER Driver,
[in, out] PGPIO_CLIENT_REGISTRATION_PACKET RegistrationPacket,
[in] PUNICODE_STRING RegistryPath
);
Parameter
[in] Driver
Ein WDFDRIVER-Handle für das Frameworktreiberobjekt für den GPIO-Controllertreiber.
[in, out] RegistrationPacket
Ein Zeiger auf eine vom Aufrufer zugewiesene GPIO_CLIENT_REGISTRATION_PACKET Struktur, die die Registrierungsinformationen des Aufrufers enthält. Diese Struktur enthält Zeiger auf die Ereignisrückruffunktionen, die der GPIO-Controllertreiber implementiert. Darüber hinaus gibt diese Struktur die Größe des Gerätekontexts an, den der GPIO-Controllertreiber für seine internen Konfigurationsdaten und Zustandsinformationen benötigt.
[in] RegistryPath
Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Pfadnamen des Registrierungsschlüssels für den GPIO-Controllertreiber enthält. Dieser Parameter sollte der Name des Registrierungspfads sein, der an die DriverEntry-Routine des Treibers übergeben wurde. Weitere Informationen zu Treiberregistrierungsschlüsseln finden Sie unter Registrierungsstrukturen für Geräte und Treiber.
Rückgabewert
GPIO_CLX_RegisterClient gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Rückgabewerte sind die folgenden Fehlercodes.
Rückgabecode | Beschreibung |
---|---|
|
Der Parameter Driver, RegistrationPacket oder RegistryPath ist NULL. |
|
Das angegebene Registrierungspaket ist ungültig. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Der GPIO-Controllertreiber ruft diese Methode auf, um seine Ereignisrückruffunktionen bei GpioClx zu registrieren. In der Regel ruft der Treiber diese Methode aus seiner DriverEntry-Routine auf, die kurz nach dem Laden des Treibers in den Arbeitsspeicher ausgeführt wird.
Später, kurz bevor der GPIO-Controllertreiber entladen wird, ruft der Treiber die GPIO_CLX_UnregisterClient-Methode auf, um die Registrierung bei GpioClx abzubrechen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8. |
Zielplattform | Universell |
Header | gpioclx.h |
Bibliothek | Msgpioclxstub.lib |
IRQL | PASSIVE_LEVEL |