Função StreamClassGetNextEvent (strmini.h)

Os minidrivers podem usar a rotina StreamClassGetNextEvent para pesquisar a fila de eventos de um dispositivo ou de um fluxo específico.

Sintaxe

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

Ponteiro para a extensão do dispositivo do minidriver. O minidriver especifica o tamanho desse buffer na estrutura HW_INITIALIZATION_DATA que ele passa quando ele se registra por meio de StreamClassRegisterMinidriver. Em seguida, o driver de classe passa ponteiros para o buffer no HwDeviceExtension membro do HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTe PORT_CONFIGURATION_INFORMATION estruturas que ele passa para o minidriver.

Este primeiro parâmetro foi PVOID HwDeviceExtension. Deve ser HwInstanceExtension para drivers de várias instâncias e vários tipos de filtro (versão 20). Os drivers de instância única herdados podem continuar a especificar HwDeviceExtension como o primeiro parâmetro. Ele também pode especificar HwInstanceExtension.

[in, optional] HwStreamObject

Ponteiro para um HW_STREAM_OBJECT. Defina como NULL para pesquisar a fila de eventos do próprio dispositivo. Para pesquisar a fila de eventos de um fluxo específico, defina como o objeto de fluxo do fluxo.

[in, optional] EventGuid

Especifica o conjunto de eventos a ser correspondido ao percorrer a fila ou NULL para corresponder a qualquer conjunto de eventos.

[in] EventItem

Especifica a ID do evento a ser correspondida ao percorrer a fila ou -1 para corresponder a qualquer evento.

[in, optional] CurrentEvent

Ponteiro para um evento na fila de eventos ou NULL .

Valor de retorno

Se CurrentEvent não estiver NULL, StreamClassGetNextEvent retornará o próximo evento correspondente após CurrentEvent na fila (ou NULL se não houver esse próximo evento). Se CurrentEvent for NULL, StreamClassGetNextEvent retornará o primeiro evento correspondente na fila.

Observações

O minidriver pode chamar StreamClassGetNextEvent sucessivamente para fazer loop pela fila de eventos, examinando um evento por vez.

O chamador pode especificar critérios de pesquisa adicionais para corresponder a eventos na fila de eventos.

Requisitos