Compartilhar via


Função ZwSetEvent (ntifs.h)

A rotina ZwSetEvent define um objeto de evento como um estado Sinalizado e tenta satisfazer o maior número possível de esperas.

Sintaxe

NTSYSAPI NTSTATUS ZwSetEvent(
  [in]            HANDLE EventHandle,
  [out, optional] PLONG  PreviousState
);

Parâmetros

[in] EventHandle

Um identificador para um objeto de evento.

[out, optional] PreviousState

Um ponteiro opcional para uma variável em que o estado anterior do objeto de evento é armazenado na saída.

Retornar valor

ZwSetEvent retorna STATUS_SUCCESS ou um erro apropriado status. Os possíveis códigos de status de erro incluem o seguinte:

Código de retorno Descrição
STATUS_ACCESS_DENIED
O chamador não tinha os privilégios necessários para modificar o evento especificado pelo parâmetro EventHandle .
STATUS_INSUFFICIENT_RESOURCES
Não foi possível alocar recursos exigidos por essa função.
STATUS_INVALID_HANDLE
O parâmetro EventHandle fornecido era inválido.

Comentários

ZwSetEvent define um objeto de evento como um estado Sinalizado e tenta satisfazer o maior número possível de esperas.

Nota Se a chamada para a função ZwSetEvent ocorrer no modo de usuário, você deverá usar o nome "NtSetEvent" em vez de "ZwSetEvent".
 
Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

IoCreateNotificationEvent

IoCreateSynchronizationEvent

KeClearEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwClose

ZwCreateEvent

ZwWaitForSingleObject