structure GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)
La structure GPIO_DISCONNECT_IO_PINS_PARAMETERS décrit un ensemble de broches d’E/S à usage général (GPIO) qui doivent être déconnectées.
Syntaxe
typedef struct _GPIO_DISCONNECT_IO_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
ULONG PinCount;
GPIO_CONNECT_IO_PINS_MODE DisconnectMode;
GPIO_DISCONNECT_IO_PINS_FLAGS DisconnectFlags;
} GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS;
Membres
BankId
Identificateur de la banque qui contient les broches GPIO. Si M est le nombre de banques dans le contrôleur GPIO, BankId est un entier compris entre 0 et M et 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énements CLIENT_QueryControllerBasicInformation . Pour plus d’informations, consultez Remarques dans CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumberTable
Pointeur vers un tableau de valeurs PIN_NUMBER. Chaque élément de tableau spécifie le nombre d’une broche GPIO à déconnecter. Si le contrôleur GPIO 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 .
DisconnectMode
Indique si les broches GPIO de la connexion en cours de fermeture sont configurées en tant qu’entrées ou en sorties. La valeur de ce membre est ConnectModeInput pour une connexion en lecture seule, ConnectModeOutput pour une connexion en écriture seule ou (ConnectModeInput | ConnectModeOutput) pour une connexion en lecture/écriture. Pour plus d’informations, consultez GPIO_CONNECT_IO_PINS_MODE.
DisconnectFlags
Ensemble d’indicateurs qui contrôlent la configuration des broches GPIO après leur fermeture. Si le bit d’indicateur PreserveConfiguration est défini, le pilote du contrôleur GPIO conserve la configuration des broches après leur déconnexion. Pour plus d'informations, consultez la section Notes.
Remarques
Le paramètre DisconnectParameters de la routine de rappel d’événement CLIENT_DisconnectIoPins est un pointeur vers une structure GPIO_CONNECT_IO_PINS_PARAMETERS .
Par défaut, lorsqu’une broche d’E/S GPIO est déconnectée, le pilote du contrôleur GPIO configure la broche dans un état initial spécifique à la plateforme. La broche est généralement configurée dans un état de faible consommation d’énergie pour réduire la charge sur la batterie. Toutefois, l’indicateur PreserveConfiguration peut être utilisé pour remplacer ce comportement par défaut. L’indicateur indique au pilote du contrôleur GPIO de conserver la configuration des broches d’E/S qui sont déconnectées.
Par exemple, un pilote de périphérique peut ouvrir une connexion logique à une broche d’E/S GPIO configurée en tant que sortie, puis écrire une valeur de bit de 1 dans la broche. L’indicateur PreserveConfiguration permet au pilote de fermer la connexion sans modifier le niveau de sortie de la broche. Plus tard, si le pilote doit modifier le niveau de sortie de la broche de 1 à 0, il ouvre une nouvelle connexion à la broche.
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