structure GPIO_DISABLE_INTERRUPT_PARAMETERS (gpioclx.h)
La structure GPIO_DISABLE_INTERRUPT_PARAMETERS décrit une broche d’interruption à 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 de framework 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 la broche numérique de cette banque, PinNumber est un entier compris entre 0 et N-1. GpioClx a obtenu précédemment 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 de désactivation des interruptions. La RetryDisableOnFailure bit d’indicateur indique qu’un appel de CLIENT_DisableInterrupt précédent pour désactiver le même épingle a échoué. Pour plus d’informations, consultez Remarques.
Remarques
Le paramètre DisableParameters de la fonction de rappel d’événement CLIENT_DisableInterrupt est un pointeur vers une structure GPIO_DISABLE_INTERRUPT_PARAMETERS allouée par l’appelant.
La fonction CLIENT_DisableInterrupt pour un contrôleur GPIO mappé en mémoire devrait toujours réussir à désactiver l’interruption. Toutefois, la fonction CLIENT_DisableInterrupt d’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 un code d’état d’erreur.
Une fois qu’un appel CLIENT_DisableInterrupt échoue, 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 effectuant des mesures supplémentaires pour augmenter la probabilité que la prochaine tentative de désactivation de l’interruption réussisse.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8. |
| d’en-tête | gpioclx.h |