PFNKSSETTIMER-Rückruffunktion (ks.h)

Die KStrSetTimer Routine eines Streaming-Minidrivers wird aufgerufen, um DPC-Zeitgeberrückrufe basierend auf der Präsentationszeit zu generieren.

Syntax

PFNKSSETTIMER Pfnkssettimer;

BOOLEAN Pfnkssettimer(
  [in] PVOID Context,
  [in] PKTIMER Timer,
  [in] LARGE_INTEGER DueTime,
  [in] PKDPC Dpc
)
{...}

Parameter

[in] Context

Zeiger auf den vom Minidriver bereitgestellten Informationskontext. Der Minidriver übergibt den Informationskontext an KsAllocateDefaultClockEx im DeferredContext- parameter der Funktion, wenn der Minidriver ein benutzerdefiniertes DPC-Timerobjekt zuweist.

[in] Timer

Zeiger auf ein Timerobjekt, das vom Minidriver zugewiesen wird.

[in] DueTime

Gibt die absolute oder relative Uhrzeit an, zu der der Timer abläuft. Wenn der Wert des DueTime- Parameters negativ ist, ist die Ablaufzeit relativ zur aktuellen Systemzeit. Andernfalls ist die Ablaufzeit absolut. Die Ablaufzeit wird in Systemzeiteinheiten ausgedrückt (100-Nanosekunden-Intervalle). Absolute Ablaufzeiten verfolgen alle Änderungen der Systemzeit; Relative Ablaufzeiten sind von Systemzeitänderungen nicht betroffen.

[in] Dpc

Zeiger auf ein DPC-Objekt, das der Minidriver mit KeInitializeDpcinitialisiert hat. Dieser Parameter ist optional.

Rückgabewert

Gibt TRUE- zurück, wenn sich das Timerobjekt bereits in der Systemzeitgeberwarteschlange befand. Andernfalls wird FALSE-zurückgegeben.

Bemerkungen

Minidriver können optional eine KStrSetTimer- Rückruffunktion als Argument für KsAllocateDefaultClockExbereitstellen.

Wenn ein Minidriver in der Regel eine KStrCorrelatedTime- Rückruffunktion bereitstellt, stellt der Minidriver auch eine KStrSetTimer- Rückruffunktion zur Auswahl.

Wenn Minidriver eine KStrSetTimer- Rückruffunktion bereitstellen, muss die Funktion Zeitgeber basierend auf Deltas auf die aktuelle Präsentationszeit festlegen, um Ereignisbenachrichtigungen zu generieren.

Wenn ein Minidriver eine KStrSetTimer- Rückruffunktion bereitstellt, muss der Minidriver auch eine KStrCancelTimer- Rückruffunktion angeben, um den Timer abzubrechen.

Der KStrSetTimer- bereitgestellte Minidriver muss dieselben Merkmale aufweisen wie KeSetTimerEx.

Anforderungen

Siehe auch

KStrCancelTimer-

KeInitializeDpc

KeSetTimerEx

KsAllocateDefaultClockEx