GPIO_DISABLE_INTERRUPT_PARAMETERS structure (gpioclx.h)
La structure GPIO_DISABLE_INTERRUPT_PARAMETERS décrit une broche d’interruption d’E/S à usage général (GPIO) à désactiver.
Syntaxe
typedef struct _GPIO_DISABLE_INTERRUPT_PARAMETERS {
BANK_ID BankId;
PIN_NUMBER PinNumber;
GPIO_DISABLE_INTERRUPT_FLAGS Flags;
} GPIO_DISABLE_INTERRUPT_PARAMETERS, *PGPIO_DISABLE_INTERRUPT_PARAMETERS;
Membres
BankId
Identificateur de la banque de broches GPIO qui contient la broche d’interruption GPIO à désactiver. 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.
PinNumber
Numéro d’épingle relatif à la banque. Si N est le nombre de broches de cette banque, PinNumber est un entier compris entre 0 et N et 1. GpioClx a précédemment obtenu le nombre de broches dans chaque banque à partir de la fonction de rappel d’événement CLIENT_QueryControllerBasicInformation . Pour plus d’informations, consultez la description du membre NumberOfPinsPerBank dans CLIENT_CONTROLLER_BASIC_INFORMATION.
Flags
Ensemble d’indicateurs pour contrôler l’opération d’interruption/désactivation. Le bit de l’indicateur RetryDisableOnFailure indique qu’un appel de CLIENT_DisableInterrupt précédent pour désactiver le même code confidentiel a échoué. Pour plus d'informations, consultez la section Notes.
Remarques
Le paramètre DisableParameters de la fonction de rappel d’événement CLIENT_DisableInterrupt est un pointeur vers une structure de GPIO_DISABLE_INTERRUPT_PARAMETERS allouée par l’appelant.
La fonction CLIENT_DisableInterrupt pour un contrôleur GPIO mappé en mémoire doit toujours réussir à désactiver l’interruption. Toutefois, la fonction CLIENT_DisableInterrupt pour un contrôleur qui n’est pas mappé en mémoire doit envoyer une demande d’E/S au contrôleur pour désactiver l’interruption, et cette requête peut échouer. Si la demande ne parvient pas à désactiver l’interruption, la fonction doit retourner une erreur status code.
Après l’échec d’un appel CLIENT_DisableInterrupt, GpioClx peut réessayer l’appel une ou plusieurs fois. Pendant chaque nouvelle tentative, GpioClx définit l’indicateur RetryDisableOnFailure pour indiquer que l’appel précédent a échoué. La fonction CLIENT_DisableInterrupt peut répondre à cet indicateur en prenant des mesures supplémentaires pour augmenter la probabilité que la prochaine tentative de désactivation de l’interruption réussisse.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 8. |
| En-tête | gpioclx.h |