PFNKSSETTIMER コールバック関数 (ks.h)
ストリーミング ミニドライバーの KStrSetTimer ルーチンは、プレゼンテーション時間に基づいて DPC タイマー コールバックを生成するために呼び出されます。
構文
PFNKSSETTIMER Pfnkssettimer;
BOOLEAN Pfnkssettimer(
[in] PVOID Context,
[in] PKTIMER Timer,
[in] LARGE_INTEGER DueTime,
[in] PKDPC Dpc
)
{...}
パラメーター
[in] Context
ミニドライバーが提供する情報コンテキストへのポインター。 ミニドライバーは、ミニドライバーがカスタム DPC タイマー オブジェクトを割り当てるときに、関数の DeferredContext パラメーターで KsAllocateDefaultClockEx に情報コンテキストを渡します。
[in] Timer
ミニドライバーによって割り当てられたタイマー オブジェクトへのポインター。
[in] DueTime
タイマーの有効期限が切れる絶対時間または相対時間を指定します。 DueTime パラメーターの値が負の場合、有効期限は現在のシステム時刻を基準とします。 それ以外の場合、有効期限は絶対です。 有効期限は、システム時間単位 (100 ナノ秒間隔) で表されます。 絶対有効期限は、システム時刻の変更を追跡します。相対有効期限は、システム時間の変更の影響を受けません。
[in] Dpc
ミニドライバーが KeInitializeDpc を使用して初期化した DPC オブジェクトへのポインター。 このパラメーターは省略できます。
戻り値
タイマー オブジェクトがシステム タイマー キューに既に存在する場合は TRUE を 返します。 それ以外の場合は、 FALSE を返します。
注釈
ミニドライバーは、必要に応じて KsAllocateDefaultClockEx への引数として KStrSetTimer コールバック関数を指定できます。
通常、ミニドライバーが KStrCorrelatedTime コールバック関数を提供する場合、ミニドライバーは KStrSetTimer コールバック関数も提供します。
ミニドライバーが KStrSetTimer コールバック関数を提供する場合、関数は、イベント通知を生成するために、デルタに基づいて現在のプレゼンテーション時刻にタイマーを設定する必要があります。
ミニドライバーが KStrSetTimer コールバック関数を提供する場合、ミニドライバーは、タイマーを取り消すために KStrCancelTimer コールバック関数も指定する必要があります。
ミニドライバーが提供する KStrSetTimer は 、KeSetTimerEx と同じ特性を持つ必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | ks.h (Ks.h を含む) |