PFNKSSETTIMER-Rückruffunktion (ks.h)

Artikel
03/05/2024

Die KStrSetTimer-Routine eines Streaming-Minidrivers wird aufgerufen, um DPC-Timer-Rü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 Vom Minidriver zugewiesenes Timerobjekt.

[in] DueTime

Gibt die absolute oder relative Zeit 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 (Intervalle von 100 Nanosekunden) ausgedrückt. Absolute Ablaufzeiten nachverfolgen alle Änderungen der Systemzeit; relative Ablaufzeiten werden von Systemzeitänderungen nicht beeinflusst.

[in] Dpc

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

Rückgabewert

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

Hinweise

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

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

Wenn Minidriver eine KStrSetTimer-Rückruffunktion bereitstellen, muss die Funktion Timer 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 bereitstellen, um den Timer abzubrechen.

Der im Lieferumfang enthaltene Minidriver KStrSetTimer muss die gleichen Eigenschaften wie KeSetTimerEx aufweisen.