GPIO_CLX_RegisterClient, fonction (gpioclx.h)

Article
08/07/2023

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
STATUS_INVALID_PARAMETER	Le paramètre Driver, RegistrationPacket ou RegistryPath est NULL.
STATUS_GPIO_INVALID_REGISTRATION_PACKET	Le paquet d’inscription spécifié n’est pas valide.
STATUS_INSUFFICIENT_RESOURCES	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

Voir aussi

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING

Partager via