Funzione KeInitializeTimer (wdm.h)

Articolo
08/08/2023

La routine KeInitializeTimer inizializza un oggetto timer.

Sintassi

void KeInitializeTimer(
  [out] PKTIMER Timer
);

Parametri

[out] Timer

Puntatore a un oggetto timer, per il quale il chiamante fornisce la risorsa di archiviazione.

Valore restituito

nessuno

Osservazioni

L'oggetto timer viene inizializzato in uno stato non segnalato.

L'archiviazione per un oggetto timer deve risiedere: nell'estensione del dispositivo di un oggetto dispositivo creato dal driver, nell'estensione controller di un oggetto controller creato dal driver o in un pool non a pagina allocato dal chiamante.

KeInitializeTimer può inizializzare solo un timer di notifica. Usare KeInitializeTimerEx per inizializzare un timer di notifica o un timer di sincronizzazione.

Usare KeSetTimer o KeSetTimerEx per definire la scadenza del timer.

Per altre informazioni sugli oggetti timer, vedere Oggetti timer e DPC.

I chiamanti di KeInitializeTimer devono essere in esecuzione in IRQL = DISPATCH_LEVEL o inferiore. È consigliabile inizializzare i timer in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (vedere la sezione Osservazioni)
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlKeDispatchLte(wdm)