SRB_INDICATE_MASTER_CLOCK
類別驅動程式會發出此要求,以向數據流指出時鐘物件的句柄,該對象現在做為其主時鐘,或是零個句柄,表示數據流可以自由執行。
傳回值
minidriver 應該將下列其中一項設定為 SRB 中的狀態:
STATUS_SUCCESS
表示命令成功完成。
STATUS_NOT_IMPLEMENTED
表示 minidriver 不支援函式。
STATUS_IO_DEVICE_ERROR
表示發生硬體失敗。
註解
類別驅動程序會設定 CommandData。pSrb指向代表主時鐘之時鐘物件的句柄的 MasterClockHandle 成員。 pSrb 指標指向HW_STREAM_REQUEST_BLOCK結構。
數據流可以藉由將主時鐘句柄傳遞至 StreamClassQueryMasterClock 或 StreamClassQueryMasterClockSync 來查詢主要時鐘的時間值。
在 minidriver 收到特定數據流的SRB_INDICATE_MASTER_CLOCK之前,它可以假設數據流可以免費執行。 如果針對次級針腳傳入此 SRB 的句柄與SRB_OPEN_MASTER_CLOCK中傳遞至minidriver的句柄 相同,minidriver 可以直接從主時鐘讀取時間,因為它控制主時鐘和次級。
minidriver 應該會在 SRB 中保留 CommandData.MasterClockHandle 字段,以指向主時鐘的句柄。 如果此句柄為零,則表示此數據流現在可免費執行,且無法從屬至主時鐘。