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