Compartilhar via


função de retorno de chamada GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS (gpioclx.h)

A função de retorno de chamada de evento CLIENT_QueryEnabledInterrupts consulta o estado de um conjunto de pinos de E/S de uso geral (GPIO) para determinar quais pinos estão configurados como entradas de interrupção e habilitados para interrupções.

Sintaxe

GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS GpioClientQueryEnabledInterrupts;

NTSTATUS GpioClientQueryEnabledInterrupts(
  [in] PVOID Context,
  [in] PGPIO_QUERY_ENABLED_INTERRUPTS_PARAMETERS QueryEnabledParameters
)
{...}

Parâmetros

[in] Context

Um ponteiro para o contexto do dispositivo do driver do controlador GPIO.

[in] QueryEnabledParameters

Um ponteiro para uma estrutura de GPIO_QUERY_ENABLED_INTERRUPTS_PARAMETERS alocada pelo chamador. Antes de chamar essa função, o chamador grava uma ID bancária no membro BankId dessa estrutura para especificar qual banco de pinos gpio consultar. Se tiver êxito, a função gravará um valor de máscara no membro EnabledMask dessa estrutura para indicar quais interrupções estão habilitadas no banco especificado.

Retornar valor

A função CLIENT_QueryEnabledInterrupts retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Começando com Windows 8.1, o driver do controlador GPIO pode, como opção, implementar uma função de retorno de chamada CLIENT_QueryEnabledInterrupts. Se implementada, essa função será chamada pela extensão da estrutura GPIO (GpioClx) para determinar quais interrupções estão habilitadas em um banco de pinos GPIO.

O parâmetro QueryEnabledParameters aponta para uma estrutura de GPIO_QUERY_ENABLED_INTERRUPTS_PARAMETERS alocada pelo chamador. O chamador define o valor do membro BankId dessa estrutura. A função CLIENT_QueryEnabledInterrupts grava no membro EnabledMask da estrutura.

Para registrar a função de retorno de chamada CLIENT_QueryEnabledInterrupts do driver, chame o método GPIO_CLX_RegisterClient . Esse método aceita, como parâmetro de entrada, um ponteiro para uma estrutura GPIO_CLIENT_REGISTRATION_PACKET que contém um ponteiro de função CLIENT_QueryEnabledInterrupts .

A função CLIENT_QueryEnabledInterrupts é opcional. Se o driver não implementar essa função, defina o membro CLIENT_QueryEnabledInterrupts da estrutura GPIO_CLIENT_REGISTRATION_PACKET como NULL.

Se a função CLIENT_QueryEnabledInterrupts for implementada, o GpioClx usará essa função para melhorar a confiabilidade do driver e diagnóstico. GpioClx chama essa função para verificar se o conjunto de interrupções habilitadas no controlador GPIO corresponde ao que o GpioClx espera. Normalmente, uma incompatibilidade indica um bug de driver que pode causar uma tempestade de interrupção. O GpioClx usa essa função para fazer uma validação de estado mais abrangente em builds verificados (depuração) e reduz o número de chamadas para essa função em builds gratuitos (varejo) para evitar afetar o desempenho. Se implementada, essa função deve ler diretamente o estado do hardware em vez de ler uma versão armazenada em cache ou mantida pelo software do estado.

GpioClx chama a função de retorno de chamada CLIENT_QueryEnabledInterrupts em PASSIVE_LEVEL ou DIRQL, dependendo das informações do dispositivo que a função de retorno de chamada CLIENT_QueryControllerBasicInformation fornece ao GpioClx. A função CLIENT_QueryControllerBasicInformation fornece informações do dispositivo na forma de uma estrutura de CLIENT_CONTROLLER_BASIC_INFORMATION . Se o bit do sinalizador MemoryMappedController estiver definido no membro Flags dessa estrutura, GpioClx chamará a função CLIENT_QueryEnabledInterrupts em DIRQL, que é o IRQL no qual o ISR em GpioClx é executado. Caso contrário, essa função será chamada em PASSIVE_LEVEL. Para obter mais informações sobre esse bit de sinalizador, consulte Funções de retorno de chamada gpio opcionais e necessárias.

Exemplos

Para definir um CLIENT_QueryEnabledInterrupts função de retorno de chamada, primeiro você deve fornecer uma declaração de função que identifique o tipo de função de retorno de chamada que você está definindo. O Windows fornece um conjunto de tipos de função de retorno de chamada para drivers. Declarar uma função usando os tipos de função de retorno de chamada ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para gravar drivers para o sistema operacional Windows.

Por exemplo, para definir uma função de retorno de chamada CLIENT_QueryEnabledInterrupts chamada MyEvtGpioQueryEnabledInterrupts, use o tipo de função GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS, conforme mostrado neste exemplo de código:

GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS MyEvtGpioQueryEnabledInterrupts;

Em seguida, implemente a função de retorno de chamada da seguinte maneira:

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioQueryEnabledInterrupts(
    PVOID Context,
    PGPIO_QUERY_ENABLED_INTERRUPTS_PARAMETERS QueryEnabledParameters
    )
{ ... }

O tipo de função GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS é definido no arquivo de cabeçalho Gpioclx.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função GPIO_CLIENT_QUERY_ENABLED_INTERRUPTS no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers KMDF. Para obter mais informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir de Windows 8.1.
Plataforma de Destino Área de Trabalho
Cabeçalho gpioclx.h
IRQL Consulte Observações.

Confira também

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_QueryControllerBasicInformation

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_RegisterClient

GPIO_QUERY_ENABLED_INTERRUPTS_PARAMETERS