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

Vedi anche

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation