共用方式為

StreamClassGetNextEvent 函式 (strmini.h)

  • 發行項

Minidrivers 可以使用 StreamClassGetNextEvent 例程來搜尋裝置或特定數據流的事件佇列。

語法

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

參數

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

迷你驅動程式裝置延伸模組的指標。 minidriver 會指定此緩衝區在透過 StreamClassRegisterMinidriver 註冊本身時所傳遞的HW_INITIALIZATION_DATA結構大小。 然後，類別驅動程式會將指標傳遞至HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT，以及PORT_CONFIGURATION_INFORMATION傳遞至minidriver的 HwDeviceExtension 成員中的緩衝區。

第一個參數是 PVOID HwDeviceExtension。 它必須是多重實例和多重篩選類型的 HwInstanceExtension， (20 版) 驅動程式。 舊版單一實例驅動程式可以繼續指定 HwDeviceExtension 做為第一個參數。 它也可以指定 HwInstanceExtension。

[in, optional] HwStreamObject

HW_STREAM_OBJECT的指標。 設定為 NULL 以搜尋裝置本身的事件佇列。 若要搜尋特定數據流的事件佇列，請將 設定為數據流的數據流物件。

[in, optional] EventGuid

指定要在排入佇列時比對的事件集，或 指定NULL 以符合任何事件集。

[in] EventItem

指定要在排入佇列時比對的事件標識碼，或 -1 以符合任何事件。

[in, optional] CurrentEvent

事件佇列中的事件指標，或 NULL。

傳回值

如果 CurrentEvent 不是 NULL，StreamClassGetNextEvent 會在佇列中的 CurrentEvent (之後傳回下一個比對事件，如果沒有這類下一個事件) 則傳回 NULL。 如果 CurrentEvent 為 NULL，StreamClassGetNextEvent 會傳回佇列中的第一個相符事件。

備註

minidriver 可以連續呼叫 StreamClassGetNextEvent ，以迴圈查看事件佇列，一次檢查一個事件。

呼叫端可以指定其他搜尋準則，以比對事件佇列上的事件。

規格需求

需求 值
目標平台 桌面
標頭 strmini.h (包含 Strmini.h)
程式庫 Stream.lib