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
STATUS_INVALID_PARAMETER	Der Parameter Driver, RegistrationPacket oder RegistryPath ist NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET	Das angegebene Registrierungspaket ist ungültig.
STATUS_INSUFFICIENT_RESOURCES	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

Weitere Informationen

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING