Função ZwSetEvent (ntifs.h)

Artigo
12/21/2024

A rotina de 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.

Valor de retorno

ZwSetEvent retorna STATUS_SUCCESS ou um status de erro apropriado. Os códigos de status de erro possíveis 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 necessários para essa função.
STATUS_INVALID_HANDLE	O parâmetro EventHandle fornecido era inválido.

Observações

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

Observação 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 versões de uma rotina dos Serviços de 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 de serviços do sistema nativo.

Requisitos

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

Consulte também

IoCreateNotificationEvent

IoCreateSynchronizationEvent

KeClearEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject

usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwClose

ZwCreateEvent

ZwWaitForSingleObject

Compartilhar via