struttura GPIO_DISABLE_INTERRUPT_PARAMETERS (gpioclx.h)
La struttura GPIO_DISABLE_INTERRUPT_PARAMETERS descrive un pin di interrupt di I/O per utilizzo generico (GPIO) da disabilitare.
Sintassi
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;
Membri
BankId
Identificatore per la banca di pin GPIO che contiene il pin di interrupt GPIO da disabilitare. Se N è il numero di banche nel controller GPIO, BankId è un numero intero compreso nell'intervallo compreso tra 0 e N-1. L'estensione del framework GPIO (GpioClx) ottenuta in precedenza il numero di banche nel controller dalla funzione di callback degli eventi CLIENT_QueryControllerBasicInformation. Per altre informazioni, vedere Osservazioni in CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumber
Numero pin relativo alla banca. Se N è il numero pin in questa banca, PinNumber è un numero intero compreso nell'intervallo compreso tra 0 e N-1. GpioClx ha ottenuto in precedenza il numero di pin in ogni banca dalla funzione di callback dell'evento CLIENT_QueryControllerBasicInformation. Per altre informazioni, vedere la descrizione del membro NumberOfPinsPerBank in CLIENT_CONTROLLER_BASIC_INFORMATION.
Flags
Set di flag per controllare l'operazione di disabilitazione degli interrupt. Il bit del flag RetryDisableOnFailure indica che una chiamata CLIENT_DisableInterrupt precedente per disabilitare lo stesso pin non è riuscita. Per altre informazioni, vedere Osservazioni.
Osservazioni
Il parametro DisableParameters della funzione di callback dell'evento CLIENT_DisableInterrupt è un puntatore a una struttura GPIO_DISABLE_INTERRUPT_PARAMETERS allocata dal chiamante.
La funzione CLIENT_DisableInterrupt per un controller GPIO mappato alla memoria dovrebbe sempre riuscire a disabilitare l'interrupt. Tuttavia, la funzione CLIENT_DisableInterrupt per un controller non mappato alla memoria deve inviare una richiesta di I/O al controller per disabilitare l'interrupt e questa richiesta potrebbe non riuscire. Se la richiesta non riesce a disabilitare l'interrupt, la funzione deve restituire un codice di stato di errore.
Dopo che una chiamata CLIENT_DisableInterrupt ha esito negativo, GpioClx potrebbe ritentare la chiamata una o più volte. Durante ogni nuovo tentativo, GpioClx imposta il flag RetryDisableOnFailure per indicare che la chiamata precedente non è riuscita. La funzione CLIENT_DisableInterrupt potrebbe rispondere a questo flag eseguendo ulteriori passaggi per aumentare la probabilità che il tentativo successivo di disabilitare l'interrupt abbia esito positivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 8. |
| intestazione | gpioclx.h |