PHW_EVENT_ROUTINE função de retorno de chamada (strmini.h)

O driver de classe chama a rotina StrMiniEvent do minidriver de fluxo para sinalizar para um minidriver que um evento deve ser habilitado ou desabilitado.

Sintaxe

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

Parâmetros

[in] EventDescriptor

Descreve o evento e se ele deve ser habilitado ou desabilitado.

Retornar valor

Para eventos de habilitação de evento, StrMiniEvent retornará STATUS_SUCCESS se o evento for habilitado com êxito ou um código de erro em caso de falha. O driver de classe ignora o valor retornado em desabilitar solicitações.

Comentários

O driver de classe enfileira a estrutura KSEVENT_ENTRY que passa em EventDescriptor-EventEntry>. Todos os outros membros do EventDescriptor são desalocados quando StrMiniEvent é encerrado, portanto, todos os dados específicos do evento contidos no membro EventData de EventDescriptor que o minidriver precisa manter devem ser armazenados pelo minidriver.

Para essa finalidade, o minidriver pode alocar espaço diretamente após a estrutura KSEVENT_ENTRY fornecendo um valor diferente de zero no membro ExtraEntryData da estrutura KSEVENT_ITEM usada para declarar o evento.

Requisitos