Funzione KePulseEvent (ntddk.h)

Articolo
08/07/2023

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)