Función StreamClassGetNextEvent (strmini.h)

Los minidrivers pueden usar la rutina 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 en el miembro HwDeviceExtension del HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT y PORT_CONFIGURATION_INFORMATION estructuras que pasa al minidriver.

Este primer parámetro era PVOID HwDeviceExtension. Debe ser HwInstanceExtension para controladores de instancias múltiples 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 coincida 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 de 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 ese evento siguiente). Si CurrentEvent es NULL, StreamClassGetNextEvent devuelve el primer evento coincidente de la cola.

Comentarios

El minidriver puede llamar a StreamClassGetNextEvent sucesivamente para recorrer en bucle la cola de eventos, examinando un evento a la 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	Value
Plataforma de destino	Escritorio
Encabezado	strmini.h (include Strmini.h)
Library	Stream.lib