Compartilhar via


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

A função de retorno de chamada de evento CLIENT_PreProcessControllerInterrupt executa qualquer pré-processamento de uma interrupção de E/S de uso geral (GPIO) que deve ser feita imediatamente se o ISR estiver agendado para ser executado posteriormente.

Sintaxe

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT GpioClientPreProcessControllerInterrupt;

NTSTATUS GpioClientPreProcessControllerInterrupt(
  [in] PVOID Context,
  [in] BANK_ID BankId,
       ULONG64 EnabledMask
)
{...}

Parâmetros

[in] Context

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

[in] BankId

O banco que contém o pino gpio de interrupção. 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 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.

EnabledMask

Retornar valor

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

Comentários

Essa função de retorno de chamada é opcional. Um driver de controlador gpio implementa essa função somente se ele executa a maior parte de sua manipulação de interrupção em PASSIVE_LEVEL, mas deve fazer algum processamento inicial de uma interrupção no DIRQL.

Normalmente, um driver de controlador GPIO pode acessar um controlador GPIO mapeado pela memória no DIRQL, mas pode acessar um controlador GPIO conectado serialmente somente em PASSIVE_LEVEL. No entanto, alguns controladores GPIO conectados serialmente podem perder a interrupção status dados se atrasarem a captura da interrupção status bits até que o IRQL caia para PASSIVE_LEVEL. Quando o IRQL cai posteriormente para PASSIVE_LEVEL, a extensão da estrutura GPIO (GpioClx) pode chamar a função de retorno de chamada CLIENT_QueryActiveInterrupts do driver para recuperar o conteúdo do registro.

O driver do controlador GPIO indica se ele deve lidar com interrupções em PASSIVE_LEVEL nas informações do dispositivo que ele passa para GpioClx durante o retorno de chamada CLIENT_QueryControllerBasicInformation . Se o controlador GPIO for mapeado pela memória, para que o driver possa acessar os registros do controlador no DIRQL, o driver definirá o bit do sinalizador MemoryMappedController no membro Flags da estrutura CLIENT_CONTROLLER_BASIC_INFORMATION que o driver passa para GpioClx. Caso contrário, o driver define MemoryMappedController = 0 para indicar que o driver deve lidar com interrupções em PASSIVE_LEVEL. Para obter mais informações, consulte ISRs de nível passivo.

Para registrar a função de retorno de chamada CLIENT_PreProcessControllerInterrupt 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_PreProcessControllerInterrupt .

Exemplos

Para definir um CLIENT_PreProcessControllerInterrupt 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_PreProcessControllerInterrupt chamada MyEvtGpioPreProcessInterrupt, use o tipo de função GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT, conforme mostrado neste exemplo de código:

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT MyEvtGpioPreProcessInterrupt;

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

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioPreProcessInterrupt(
    PVOID Context
    )
{ ... }

O tipo de função GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT é 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_PRE_PROCESS_CONTROLLER_INTERRUPT 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 começando com Windows 8.
Plataforma de Destino Área de Trabalho
Cabeçalho gpioclx.h
IRQL Chamado em DIRQL.

Confira também

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_RegisterClient