Funzione KeInitializeTimerEx (wdm.h)

Articolo
03/08/2023

La routine KeInitializeTimerEx inizializza un oggetto timer del kernel esteso.

Sintassi

void KeInitializeTimerEx(
  [out] PKTIMER    Timer,
  [in]  TIMER_TYPE Type
);

Parametri

[out] Timer

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

[in] Type

Specifica il tipo dell'oggetto timer, NotificationTimer o SynchronizationTimer.

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.

Quando un timer di notifica scade, tutti i thread in attesa vengono rilasciati e il timer rimane nello stato segnalato fino a quando non viene reimpostato in modo esplicito. Quando un timer di sincronizzazione scade, viene impostato su uno stato segnalato fino a quando non viene rilasciato un singolo thread in attesa e quindi il timer viene reimpostato su uno stato non segnalato.

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

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

Usare KeSetTimer o KeSetTimerEx per definire la scadenza del timer.

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)