GPIO_DISABLE_INTERRUPT_PARAMETERS struttura (gpioclx.h)
La struttura GPIO_DISABLE_INTERRUPT_PARAMETERS descrive un pin di interruzione di I/O (GPIO) per utilizzo generico per 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;
Members
BankId
Identificatore per la banca dei pin GPIO che contiene il pin di interruzione GPIO da disabilitare. Se N è il numero di banche nel controller GPIO, BankId è un intero nell'intervallo da 0 a N-1. L'estensione del framework GPIO (GpioClx) ha ottenuto 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 di pin relativo alla banca. Se N è il numero pin in questa banca, PinNumber è un numero intero nell'intervallo da 0 a 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 interruzioni. Il bit del flag RetryDisableOnFailure indica che una chiamata precedente CLIENT_DisableInterrupt per disabilitare lo stesso pin non è riuscita. Per altre informazioni, vedere la sezione Osservazioni.
Commenti
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 deve sempre riuscire a disabilitare l'interruzione. Tuttavia, la funzione CLIENT_DisableInterrupt per un controller che non è mappata alla memoria deve inviare una richiesta di I/O al controller per disabilitare l'interruzione e questa richiesta potrebbe non riuscire. Se la richiesta non riesce a disabilitare l'interruzione, la funzione deve restituire un codice di stato di errore.
Dopo che una chiamata CLIENT_DisableInterrupt ha esito negativo, GpioClx potrebbe ripetere la chiamata una o più volte. Durante ogni tentativo, GpioClx imposta il flag RetryDisableOnFailure per indicare che la chiamata precedente non è riuscita. La funzione CLIENT_DisableInterrupt potrebbe rispondere a questo flag eseguendo passaggi aggiuntivi per aumentare la probabilità che il successivo tentativo di disabilitare l'interruzione abbia esito positivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 8. |
| Intestazione | gpioclx.h |