KsAllocateDefaultClock 関数 (ks.h)
KsAllocateDefaultClock 関数は、既定のクロック構造を割り当てて初期化します。
構文
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
パラメーター
[out] DefaultClock
呼び出し元によって割り当てられた共有の既定のクロック構造を指定します。 現在の時刻は 0 に設定され、状態は KSSTATE_STOP に設定されます。 このルーチンが正常に完了すると、このポインターによって示される構造体には、既定のクロックへの参照が含まれます。 返されるデータは不透明として扱い、システム使用のために予約する必要があります。
戻り値
KsAllocateDefaultClock 関数は、成功した場合はSTATUS_SUCCESSを返し、失敗した場合はメモリ エラーを返します。
注釈
内部 DefaultClock.ReferenceCount 要素は、 KsAllocateDefaultClock 関数によって 1 つに初期化されます。 各通知 DPC がキューに登録され、完了すると、要素はインクリメントされ、デクリメントされます。 構造体を解放する場合、 要素を使用して、クロックの所有者が構造体を解放する必要があるかどうか、または保留中の DPC が非同期的に解放する必要があるかどうかを判断します。
クロックが不要になった場合、ドライバーは KsFreeDefaultClock を呼び出して、クロックで使用するために割り当てられたリソースを解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | PASSIVE_LEVEL |