Funzione KeInitializeTimerEx (wdm.h)
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) |