Compartilhar via


estrutura GPIO_DISABLE_INTERRUPT_PARAMETERS (gpioclx.h)

A estrutura GPIO_DISABLE_INTERRUPT_PARAMETERS descreve um pino de interrupção de E/S de uso geral (GPIO) 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 extensão da estrutura gpio (GpioClx) 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 de sinalizador RetryDisableOnFailure indica que uma chamada CLIENT_DisableInterrupt anterior para desabilitar o mesmo pin falhou. Para obter mais informações, consulte Comentários.

Observações

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 por memória sempre tenha êxito em desabilitar a interrupção. No entanto, a função CLIENT_DisableInterrupt para um controlador que não é mapeado pela 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 não desabilitar a interrupção, a função deverá retornar um código de status de erro.

Depois que uma chamada CLIENT_DisableInterrupt falhar, o 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 tomando medidas adicionais para aumentar a probabilidade de que a próxima tentativa de desabilitar a interrupção seja bem-sucedida.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte a partir do Windows 8.
cabeçalho gpioclx.h

Consulte também

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation