PFNKSSETTIMER 回呼函式 (ks.h)
系統會呼叫串流迷你驅動程式的 KStrSetTimer 例程,以根據簡報時間產生 DPC 定時器回呼。
語法
PFNKSSETTIMER Pfnkssettimer;
BOOLEAN Pfnkssettimer(
[in] PVOID Context,
[in] PKTIMER Timer,
[in] LARGE_INTEGER DueTime,
[in] PKDPC Dpc
)
{...}
參數
[in] Context
minidriver 提供的資訊內容的指標。 當 minidriver 配置自定義 DPC 定時器物件時,minidriver 會將資訊內容傳遞至函式的 DeferredContext 參數中的 KsAllocateDefaultClockEx。
[in] Timer
Minidriver 所配置的定時器物件的指標。
[in] DueTime
指定定時器到期的絕對或相對時間。 如果 DueTime 參數的值是負數,則到期時間會相對於目前的系統時間。 否則,到期時間是絕對的。 到期時間是以系統時間單位表示, (100 奈秒的間隔) 。 絕對到期時間會追蹤系統時間中的任何變更;相對到期時間不會受到系統時間變更的影響。
[in] Dpc
使用 KeInitializeDpc 初始化之迷你驅動程式之 DPC 物件的指標。 這是選擇性參數。
傳回值
如果定時器對象已經在系統定時器佇列中,則傳回 TRUE 。 否則會傳回 FALSE。
備註
Minidrivers 可以選擇性地提供 KStrSetTimer 回呼函式作為 KsAllocateDefaultClockEx 的自變數。
一般而言,如果 minidriver 提供 KStrCorrelatedTime 回呼函式,則 minidriver 也會提供 KStrSetTimer 回呼函式。
如果 minidrivers 提供 KStrSetTimer 回呼函式,則函式必須根據差異將定時器設定為目前的簡報時間,才能產生事件通知。
如果 minidriver 提供 KStrSetTimer 回呼函式,minidriver 也必須提供 KStrCancelTimer 回呼函式來取消定時器。
提供的 minidriver KStrSetTimer 必須具有與 KeSetTimerEx 相同的特性。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | ks.h (包含 Ks.h) |