PFNKSCORRELATEDTIME コールバック関数 (ks.h)

ストリーミングミニドライバーの KStrCorrelatedTime ルーチンは、プレゼンテーション時間と物理時間の両方を関連付けられた方法で取得するために呼び出されます。これにより、クロック所有者は現在の時刻を完全に決定できます。

構文

PFNKSCORRELATEDTIME Pfnkscorrelatedtime;

LONGLONG Pfnkscorrelatedtime(
  [in]  PVOID Context,
  [out] PLONGLONG SystemTime
)
{...}

[in] Context

ミニドライバーが提供する情報コンテキストへのポインター。ミニドライバーは、ミニドライバーがカスタム DPC タイマーオブジェクトを割り当てるときに、関数の DeferredContext パラメーターで KsAllocateDefaultClockEx をする情報コンテキストを渡します。

[out] SystemTime

パフォーマンスカウンターの頻度を受け取る変数へのポインターを指定します。

ティック単位でパフォーマンスカウンターの値を返します。

通常、ミニドライバーが KStrCorrelatedTime コールバック関数 を提供する場合、ミニドライバーは KStrSetTimer を指定し、KStrCancelTimer コールバック関数をする必要もあります。

ミニドライバーが提供する KStrCorrelatedTimer は、KeQueryPerformanceCounter と同じ特性を持つ必要があります。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	ks.h (Ks.h を含む)