Funzione di callback PFNKSSETTIMER (ks.h)

Articolo
02/29/2024

Una routine KStrSetTimer di streaming viene chiamata per generare callback timer DPC in base all'ora di presentazione.

Sintassi

PFNKSSETTIMER Pfnkssettimer;

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

Parametri

[in] Context

Puntatore al contesto informativo fornito dal minidriver. Il minidriver passa il contesto informativo a KsAllocateDefaultClockEx nel parametro DeferredContext della funzione quando il minidriver alloca un oggetto timer DPC personalizzato.

[in] Timer

Puntatore a un oggetto timer allocato dal minidriver.

[in] DueTime

Specifica il tempo assoluto o relativo in cui scade il timer. Se il valore del parametro DueTime è negativo, l'ora di scadenza è relativa all'ora di sistema corrente. In caso contrario, l'ora di scadenza è assoluta. L'ora di scadenza viene espressa nelle unità temporali di sistema (intervalli di 100 nanosecondi). I tempi di scadenza assoluti tengono traccia delle modifiche apportate all'ora di sistema; le ore di scadenza relative non sono interessate dalle modifiche all'ora di sistema.

[in] Dpc

Puntatore a un oggetto DPC inizializzato dal minidriver usando KeInitializeDpc. Questo parametro è facoltativo e,

Valore restituito

Restituisce TRUE se l'oggetto timer era già presente nella coda timer di sistema. In caso contrario, restituisce FALSE.

Commenti

I minidriver possono facoltativamente fornire una funzione di callback KStrSetTimer come argomento a KsAllocateDefaultClockEx.

In genere, se un minidriver fornisce una funzione di callback KStrCorrelatedTime , il minidriver fornisce anche una funzione di callback KStrSetTimer .

Se i minidriver forniscono una funzione di callback KStrSetTimer , la funzione deve impostare timer, in base ai delta, all'ora di presentazione corrente per generare notifiche degli eventi.

Se un minidriver fornisce una funzione di callback KStrSetTimer , il minidriver deve anche fornire una funzione di callback KStrCancelTimer per annullare il timer.

Il minidriver fornito KStrSetTimer deve avere le stesse caratteristiche di KeSetTimerEx.