StreamClassQueryMasterClockSync 函式 (strmini.h)
minidriver 可以呼叫 StreamClassQueryMasterClockSync 例程,以同步查詢數據流的主時鐘。
語法
VOID STREAMAPI StreamClassQueryMasterClockSync(
[in] HANDLE MasterClockHandle,
[in, out] PHW_TIME_CONTEXT TimeContext
);
參數
[in] MasterClockHandle
指定正在查詢之主時鐘的句柄。 類別驅動程式會在SRB_INDICATE_MASTER_CLOCK要求中將此傳遞至minidriver的 StrMiniReceiveStreamControlPacket 例程。
[in, out] TimeContext
指定類別驅動程式傳遞至主時鐘 StrMiniClock 例程的HW_TIME_CONTEXT結構。 呼叫此例程之前,minidriver 必須填入 HwDeviceExtension、HwStreamObject 和 TimeContext 的 Function 成員。 StreamClassQueryMasterClockSync 會完成 Time 和 SystemTime 成員。
傳回值
無
備註
例程必須在 DISPATCH_LEVEL 或以下呼叫。 如果呼叫端是在引發的 IRQL 上執行,則應該改用異步版本 StreamClassQueryMasterClock。
類別驅動程式會呼叫主時鐘的 StrMiniClock 例程來查詢時鐘。
在少數情況下,圖形管理員會切換主要時鐘。 類別驅動程式會在處理新的主時鐘時公開競爭條件。 如果 minidriver 在收到類別驅動程式的新時鐘之後立即呼叫數據流類別主時鐘例程,類別驅動程式可能會產生非預期的結果。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | strmini.h (包含 Strmini.h) |
程式庫 | Stream.lib |
IRQL | <=DISPATCH_LEVEL (請參閱一節) |