KsAllocateDefaultClock 函式 (ks.h)
KsAllocateDefaultClock 函式會配置並初始化預設時鐘結構。
語法
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
參數
[out] DefaultClock
指定呼叫端配置的共享預設時鐘結構。 目前的時間設定為零,且狀態設定為 KSSTATE_STOP。 成功完成此例程時,此指標所指示的結構將會包含預設時鐘的參考。 傳回的數據應該視為不透明,並保留供系統使用。
傳回值
KsAllocateDefaultClock 函式會在成功時傳回STATUS_SUCCESS,如果失敗則傳回記憶體錯誤。
言論
內部 DefaultClock.ReferenceCount 元素會由 KsAllocateDefaultClock 函式初始化為一個元素。 元素會隨著每個通知 DPC 排入佇列並完成而遞減。 當結構要釋放時,會使用 元素來判斷時鐘的擁有者是否應該釋放結構,或擱置的 DPC 是否應該以異步方式釋放它。
當不再需要時鐘時,驅動程式必須呼叫 KsFreeDefaultClock,以釋放配置用於時鐘的任何資源。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | PASSIVE_LEVEL |