função de retorno de chamada PCPFNEVENT_HANDLER (portcls.h)

Artigo
03/01/2024

Uma EventHandler rotina processa solicitações de evento.

Sintaxe

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

Parâmetros

[in] EventRequest

Ponteiro para uma estrutura de PCEVENT_REQUEST inicializada

Retornar valor

O manipulador de eventos retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Cada evento que um driver de miniporto expõe está associado a um manipulador de eventos. A finalidade do manipulador de eventos é processar solicitações de eventos do driver de porta e de seus clientes. EventRequest é um parâmetro de entrada para o manipulador que contém as seguintes informações sobre o evento:

O GUID do conjunto de eventos e a ID do evento.
Como o evento deve ser disparado.
Ponteiros para o objeto de miniporto de destino e (para um pino) objeto de fluxo.

Isso é semelhante ao tipo de informações fornecidas com solicitações de propriedade.

O driver de miniporto expõe seus manipuladores de eventos por meio de seu método IMiniport::GetDescription . Esse método gera uma estrutura de descritor (consulte PCFILTER_DESCRIPTOR) que define o filtro que o driver de miniporto e seu driver de porta associado implementam juntos. Essa estrutura contém um ponteiro para a tabela de automação do driver de miniporto (consulte PCAUTOMATION_TABLE), que, por sua vez, contém um ponteiro para uma matriz de eventos do driver de miniporto. Cada elemento de matriz é uma estrutura PCEVENT_ITEM e contém um ponteiro de função PCPFNEVENT_HANDLER para o manipulador do evento.

A EventHandler rotina deve residir na memória nãopagada.