estrutura GPIO_DISABLE_INTERRUPT_PARAMETERS (gpioclx.h)
A estrutura GPIO_DISABLE_INTERRUPT_PARAMETERS descreve um pino de interrupção de GPIO (E/S de uso geral) para desabilitar.
Sintaxe
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;
Membros
BankId
O identificador do banco de pinos GPIO que contém o pino de interrupção GPIO a ser desabilitado. Se N for o número de bancos no controlador GPIO, BankId será um inteiro no intervalo de 0 a N-1. A gpioClx (extensão de estrutura gpio) obteve anteriormente o número de bancos no controlador da função de retorno de chamada de evento CLIENT_QueryControllerBasicInformation . Para obter mais informações, consulte Comentários em CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumber
O número do pino relativo ao banco. Se N for o número de pinos neste banco, PinNumber será um inteiro no intervalo de 0 a N–1. O GpioClx obteve anteriormente o número de pinos em cada banco da função de retorno de chamada de evento CLIENT_QueryControllerBasicInformation . Para obter mais informações, consulte a descrição do membro NumberOfPinsPerBank no CLIENT_CONTROLLER_BASIC_INFORMATION.
Flags
Um conjunto de sinalizadores para controlar a operação de desabilitação de interrupção. O bit do sinalizador RetryDisableOnFailure indica que uma chamada CLIENT_DisableInterrupt anterior para desabilitar o mesmo pin falhou. Para obter mais informações, consulte Comentários.
Comentários
O parâmetro DisableParameters da função de retorno de chamada de evento CLIENT_DisableInterrupt é um ponteiro para uma estrutura de GPIO_DISABLE_INTERRUPT_PARAMETERS alocada pelo chamador.
Espera-se que a função CLIENT_DisableInterrupt para um controlador GPIO mapeado em memória sempre tenha êxito na desabilitação da interrupção. No entanto, a função CLIENT_DisableInterrupt para um controlador que não é mapeado na memória deve enviar uma solicitação de E/S ao controlador para desabilitar a interrupção e essa solicitação pode falhar. Se a solicitação falhar ao desabilitar a interrupção, a função deverá retornar um erro status código.
Depois que uma chamada CLIENT_DisableInterrupt falhar, GpioClx poderá repetir a chamada uma ou mais vezes. Durante cada repetição, GpioClx define o sinalizador RetryDisableOnFailure para indicar que a chamada anterior falhou. A função CLIENT_DisableInterrupt pode responder a esse sinalizador executando etapas adicionais para aumentar a probabilidade de que a próxima tentativa de desabilitar a interrupção seja bem-sucedida.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Com suporte a partir do Windows 8. |
Cabeçalho | gpioclx.h |