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,以及 Function timeContext 的成員。 StreamClassQueryMasterClockSync 會完成 Time 和 SystemTime 成員。
傳回值
沒有
言論
例程必須在 DISPATCH_LEVEL 或以下呼叫。 如果呼叫端在引發的 IRQL 上執行,則應該改用異步版本,StreamClassQueryMasterClock。
類別驅動程式會呼叫主時鐘的 StrMiniClock 例程來查詢時鐘。
在極少數情況下,圖形管理員會切換主要時鐘。 類別驅動程式會在處理新的主時鐘時公開競爭條件。 如果 minidriver 在收到類別驅動程式的新時鐘之後立即呼叫數據流類別主時鐘例程,則類別驅動程式可能會產生非預期的結果。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | strmini.h (包括 Strmini.h) |
連結庫 | Stream.lib |
IRQL | <=DISPATCH_LEVEL (請參閱一節) |