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 呼び出して、クロックで使用するために割り当てられたリソースを解放する必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib
IRQL	PASSIVE_LEVEL

関連項目

KsAllocateDefaultClockEx の

KsFreeDefaultClock