Funzione KePulseEvent (ntddk.h)
La routine KePulseEvent imposta atomicamente un oggetto evento su uno stato segnalato, tenta di soddisfare il maggior numero possibile di attese e quindi reimposta l'oggetto evento su uno stato non segnalato.
Sintassi
LONG KePulseEvent(
[in, out] PRKEVENT Event,
[in] KPRIORITY Increment,
[in] BOOLEAN Wait
);
Parametri
[in, out] Event
Puntatore a un oggetto dispatcher di tipo KEVENT.
[in] Increment
Specifica un incremento da applicare alla priorità dei thread che vengono letti come risultato della pulsazione dell'evento. In genere impostato su zero, ma può essere impostato su uno.
[in] Wait
Specifica un valore booleano che indica se la chiamata a KePulseEvent verrà immediatamente seguita da una chiamata a una delle routine KeWaitXxx . Se TRUE, la chiamata KePulseEvent viene immediatamente seguita da una chiamata a KeWaitForMultipleObjects, KeWaitForMutexObject o KeWaitForSingleObject. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
Stato del segnale precedente dell'oggetto evento.
Commenti
Per altre informazioni sugli oggetti evento, vedere Oggetti evento.
La routine KePulseEvent potrebbe generare temporaneamente irQL. Se il parametro Wait è FALSE, la routine, prima che venga restituita, ripristina irQL sul valore originale che aveva all'inizio della chiamata.
Se WaitTRUE, la routine restituisce = senza abbassare il valore IRQL. In questo caso, la chiamata KePulseEvent deve essere immediatamente seguita da una chiamata KeWaitXxx . Impostando Wait = TRUE, il chiamante può impedire che si verifichi un cambio di contesto non necessario tra la chiamata KePulseEvent e la chiamata KeWaitXxx . La routine KeWaitXxx , prima di restituire, ripristina il valore originale di IRQL all'inizio della chiamata KePulseEvent . Anche se IRQL disabilita i commutatori di contesto tra le due chiamate, queste chiamate non possono essere usate in modo affidabile come inizio e fine di un'operazione atomica. Ad esempio, tra queste due chiamate, un thread in esecuzione contemporaneamente in un altro processore potrebbe modificare lo stato dell'oggetto evento o della destinazione dell'attesa.
Se il chiamante è in esecuzione in IRQL = DISPATCH_LEVEL o in un contesto di thread arbitrario, il parametro Timeout su KeWaitXxx deve essere zero.
Avviso
Se un thread in attesa di Evento esegue attualmente un kernel APC, quando viene chiamato KePulseEvent , l'attesa del thread non viene soddisfatta. Al termine del kernel APC, il thread rimane nello stato di attesa.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | ntddk.h (include Ntddk.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport), IrqlKeDispatchLte(wdm) |