PHW_EVENT_ROUTINE función de devolución de llamada (strmini.h)

El controlador de clase llama a la rutina de StrMini Event de la secuencia del minidriver para indicar a un minidriver que un evento debe estar habilitado o deshabilitado.

Sintaxis

PHW_EVENT_ROUTINE PhwEventRoutine;

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

Parámetros

[in] EventDescriptor

Describe el evento y si se debe habilitar o deshabilitar.

Valor devuelto

Para los eventos de habilitación de eventos, StrMiniEvent devuelve STATUS_SUCCESS si el evento está habilitado correctamente o un código de error en caso de error. El controlador de clase omite el valor devuelto en las solicitudes de deshabilitación.

Observaciones

El controlador de clase pone en cola la estructura de KSEVENT_ENTRY que pasa en eventDescriptor:>EventEntry. Cada otro miembro de EventDescriptor se desasigna una vez StrMiniEvent, por lo que cualquier dato específico del evento contenido en el EventData miembro de EventDescriptor que el minidriver debe conservarse por el minidriver.

Para ello, el minidriver puede asignar espacio directamente después de la estructura KSEVENT_ENTRY proporcionando un valor distinto de cero en el miembro ExtraEntryData de la estructura KSEVENT_ITEM que usó para declarar el evento.

Requisitos