Compartir a través de

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

  • Artículo

El controlador de clase llama a la rutina StrMiniEvent del minidriver de la secuencia para indicar a un minidriver que se debe habilitar o deshabilitar un evento.

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

En el caso de 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.

Comentarios

El controlador de clase pone en cola la estructura KSEVENT_ENTRY que pasa en EventDescriptor-EventEntry>. Todos los demás miembros de EventDescriptor se desasignan una vez que se cierra StrMiniEvent , por lo que los datos específicos del evento contenidos en el miembro EventData de EventDescriptor que el minidriver necesita mantener deben almacenarse en 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

Requisito Value
Plataforma de destino Escritorio
Encabezado strmini.h (include Strmini.h)