Compartilhar via


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

Confira também

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation