共用方式為


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

另請參閱

KsAllocateDefaultClockEx

KsFreeDefaultClock