GPIO_CLX_RegisterClient, fonction (gpioclx.h)
La méthode GPIO_CLX_RegisterClient inscrit un pilote de contrôleur d’E/S à usage général (GPIO) en tant que client de l’extension d’infrastructure GPIO (GpioClx).
Syntaxe
NTSTATUS GPIO_CLX_RegisterClient(
[in] WDFDRIVER Driver,
[in, out] PGPIO_CLIENT_REGISTRATION_PACKET RegistrationPacket,
[in] PUNICODE_STRING RegistryPath
);
Paramètres
[in] Driver
Un handle WDFDRIVER vers l’objet pilote d’infrastructure pour le pilote de contrôleur GPIO.
[in, out] RegistrationPacket
Pointeur vers une structure de GPIO_CLIENT_REGISTRATION_PACKET allouée à l’appelant qui contient les informations d’inscription de l’appelant. Cette structure contient des pointeurs vers les fonctions de rappel d’événement que le pilote du contrôleur GPIO implémente. En outre, cette structure spécifie la taille du contexte de périphérique dont le pilote de contrôleur GPIO a besoin pour ses données de configuration internes et ses informations d’état.
[in] RegistryPath
Pointeur vers une structure UNICODE_STRING qui contient le nom de chemin d’accès de la clé de Registre pour le pilote du contrôleur GPIO. Ce paramètre doit être le nom du chemin d’accès du Registre qui a été passé à la routine DriverEntry du pilote. Pour plus d’informations sur les clés de Registre des pilotes, consultez Arborescences de registre pour les périphériques et les pilotes.
Valeur retournée
GPIO_CLX_RegisterClient retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour possibles incluent les codes d’erreur suivants.
Code de retour | Description |
---|---|
|
Le paramètre Driver, RegistrationPacket ou RegistryPath est NULL. |
|
Le paquet d’inscription spécifié n’est pas valide. |
|
Mémoire insuffisante. |
Remarques
Le pilote du contrôleur GPIO appelle cette méthode pour inscrire ses fonctions de rappel d’événements auprès de GpioClx. En règle générale, le pilote appelle cette méthode à partir de sa routine DriverEntry , qui s’exécute peu après le chargement du pilote en mémoire.
Plus tard, juste avant le déchargement du pilote du contrôleur GPIO, le pilote appelle la méthode GPIO_CLX_UnregisterClient pour annuler son inscription auprès de GpioClx.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 8. |
Plateforme cible | Universal |
En-tête | gpioclx.h |
Bibliothèque | Msgpioclxstub.lib |
IRQL | PASSIVE_LEVEL |