共用方式為

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 結構中傳遞的這個緩衝區大小。 然後，類別驅動程式會將指標傳遞至 HwDeviceExtension 中HW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT，以及 PORT_CONFIGURATION_INFORMATION 傳遞至迷你驅動程序的結構。

第一個參數是 PVOID HwDeviceExtension。 它必須是多重實例和多重篩選類型 （版本 20） 驅動程式的 HwInstanceExtension。 舊版單一實例驅動程式可以繼續將 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