Funzione StreamClassGetNextEvent (strmini.h)

Articolo
08/07/2023

I minidriver possono usare la routine StreamClassGetNextEvent per cercare la coda di eventi di un dispositivo o di un determinato flusso.

Sintassi

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
);

Parametri

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

Puntatore all'estensione del dispositivo del minidriver. Il minidriver specifica le dimensioni di questo buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra tramite StreamClassRegisterMinidriver. Il driver di classe passa quindi puntatori al buffer nel membro HwDeviceExtension del HW_STREAM_REQUEST_BLOCK ,HW_STREAM_OBJECT, HW_TIME_CONTEXT e PORT_CONFIGURATION_INFORMATION strutture che passa al minidriver.

Questo primo parametro era PVOID HwDeviceExtension. Deve essere HwInstanceExtension per i driver multi-istanza e multi-filtro (versione 20). I driver di istanza singola legacy possono continuare a specificare HwDeviceExtension come primo parametro. Può anche specificare HwInstanceExtension.

[in, optional] HwStreamObject

Puntatore a un HW_STREAM_OBJECT. Impostare su NULL per cercare la coda di eventi del dispositivo stesso. Per cercare la coda di eventi di un flusso specifico, impostare sull'oggetto stream del flusso del flusso.

[in, optional] EventGuid

Specifica il set di eventi da corrispondere quando si esegue la coda o NULL per corrispondere a qualsiasi set di eventi.

[in] EventItem

Specifica l'ID evento da corrispondere quando si esegue la coda o -1 per corrispondere a qualsiasi evento.

[in, optional] CurrentEvent

Puntatore a un evento nella coda di eventi o NULL.

Valore restituito

Se CurrentEvent non è NULL, StreamClassGetNextEvent restituisce l'evento corrispondente successivo dopo CurrentEvent nella coda (o NULL se non è presente alcun evento successivo). Se CurrentEvent è NULL, StreamClassGetNextEventrestituisce il primo evento corrispondente nella coda.

Commenti

Il minidriver può chiamare StreamClassGetNextEvent successivamente per eseguire il ciclo attraverso la coda di eventi, esaminando un evento alla volta.

Il chiamante può specificare criteri di ricerca aggiuntivi per corrispondere agli eventi nella coda di eventi.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	strmini.h (include Strmini.h)
Libreria	Stream.lib

Condividi tramite