GPIO_READ_PINS_PARAMETERS structure (gpioclx.h)

Article
02/26/2024

La structure GPIO_READ_PINS_PARAMETERS décrit une opération de lecture sur un groupe de broches d’E/S à usage général (GPIO).

Syntaxe

typedef struct _GPIO_READ_PINS_PARAMETERS {
  BANK_ID              BankId;
  PPIN_NUMBER          PinNumberTable;
  ULONG                PinCount;
  PVOID                Buffer;
  GPIO_READ_PINS_FLAGS Flags;
  PVOID                Reserved;
} GPIO_READ_PINS_PARAMETERS, *PGPIO_READ_PINS_PARAMETERS;

Membres

BankId

Identificateur de la banque de broches GPIO qui contient les broches à lire. Si N est le nombre de banques dans le contrôleur GPIO, BankId est un entier compris entre 0 et N–1. L’extension d’infrastructure GPIO (GpioClx) a précédemment obtenu le nombre de banques dans le contrôleur à partir de la fonction de rappel d’événement CLIENT_QueryControllerBasicInformation . Pour plus d’informations, consultez Remarques dans CLIENT_CONTROLLER_BASIC_INFORMATION.

PinNumberTable

Pointeur vers un tableau de valeurs de PIN_NUMBER relatives aux banques. Chaque élément de tableau spécifie le numéro d’une broche GPIO à partir de laquelle lire. Si cette banque a N broches, les broches sont numérotées de 0 à N–1. Le nombre d’éléments dans ce tableau est spécifié par le membre PinCount .

PinCount

Nombre d’éléments dans le tableau PinNumberTable .

Buffer

Pointeur vers une mémoire tampon pour contenir les valeurs que le pilote du contrôleur GPIO lit à partir des broches GPIO spécifiées par le tableau PinNumberTable . L’élément array 0 spécifie la broche GPIO dont la valeur est enregistrée sur le bit 0 (le bit le moins significatif) dans la mémoire tampon, l’élément de tableau 1 spécifie la broche GPIO dont la valeur est enregistrée au bit 1 dans la mémoire tampon, et ainsi de suite.

Flags

Ensemble d’indicateurs pour contrôler l’opération de lecture de broche GPIO. Si le bit d’indicateur WriteConfiguredPins est défini, le pilote du contrôleur GPIO peut lire à partir d’une broche GPIO configurée pour les opérations d’écriture.

Reserved

Réservé pour le système.

Remarques

Le paramètre ReadParameters de la fonction de rappel d’événement CLIENT_ReadGpioPins est un pointeur vers une structure de GPIO_READ_PINS_PARAMETERS allouée par l’appelant. Toutes les broches lues par cette fonction font partie de la même banque de broches GPIO.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 8.
En-tête	gpioclx.h

Voir aussi

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_QueryControllerBasicInformation

CLIENT_ReadGpioPins

Partager via