Función StreamClassGetNextEvent (strmini.h)

Los minidrivers pueden usar la rutina de StreamClassGetNextEvent para buscar en la cola de eventos de un dispositivo o de una secuencia determinada.

Sintaxis

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

Parámetros

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

Puntero a la extensión del dispositivo del minidriver. El minidriver especifica el tamaño de este búfer en la estructura HW_INITIALIZATION_DATA que pasa cuando se registra a sí mismo a través de StreamClassRegisterMinidriver. A continuación, el controlador de clase pasa punteros al búfer de la HwDeviceExtension miembro del HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTy PORT_CONFIGURATION_INFORMATION estructuras que pasa al minidriver.

Este primer parámetro era PVOID HwDeviceExtension. Debe ser HwInstanceExtension para los controladores multiinstancia y de varios filtros (versión 20). Los controladores de instancia única heredados pueden seguir especificando HwDeviceExtension como primer parámetro. También puede especificar HwInstanceExtension.

[in, optional] HwStreamObject

Puntero a un HW_STREAM_OBJECT. Establezca en NULL para buscar en la cola de eventos del propio dispositivo. Para buscar en la cola de eventos de una secuencia determinada, establezca en el objeto stream del flujo.

[in, optional] EventGuid

Especifica el conjunto de eventos que debe coincidir al recorrer la cola o NULL para que coincidan con cualquier conjunto de eventos.

[in] EventItem

Especifica el identificador de evento que debe coincidir al recorrer la cola o -1 para que coincida con cualquier evento.

[in, optional] CurrentEvent

Puntero a un evento en la cola de eventos o NULL.

Valor devuelto

Si CurrentEvent no es NULL, StreamClassGetNextEvent devuelve el siguiente evento coincidente después de CurrentEvent en la cola (o NULL si no hay ningún evento siguiente). Si CurrentEvent es null, StreamClassGetNextEvent devuelve el primer evento coincidente de la cola.

Observaciones

El minidriver puede llamar a StreamClassGetNextEvent sucesivamente para recorrer la cola de eventos, examinando un evento cada vez.

El autor de la llamada puede especificar criterios de búsqueda adicionales para que coincidan con eventos en la cola de eventos.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	strmini.h (incluya Strmini.h)
biblioteca de	Stream.lib