Поделиться через

Функция ZwSetEvent (ntifs.h)

Подпрограмма ZwSetEvent задает объект события в состояние Signaled и пытается удовлетворить максимальное количество ожиданий.

Синтаксис

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

Параметры

[in] EventHandle

Дескриптор объекта события.

[out, optional] PreviousState

Необязательный указатель на переменную, в которой предыдущее состояние объекта события хранится в выходных данных.

Возвращаемое значение

ZwSetEvent возвращает STATUS_SUCCESS или соответствующее состояние ошибки. Возможные коды состояния ошибок включают следующие:

Возвращаемый код Описание
STATUS_ACCESS_DENIED
 Вызывающий объект не имеет необходимых привилегий для изменения события, указанного параметром EventHandle.
STATUS_INSUFFICIENT_RESOURCES
 Ресурсы, необходимые этой функции, не могут быть выделены.
STATUS_INVALID_HANDLE
 Указанный параметр EventHandle был недопустимым.

Замечания

ZwSetEvent задает объект события в состояние Signaled и пытается удовлетворить максимально возможное количество ожиданий.

Примечание Если вызов функции ZwSetEvent происходит в пользовательском режиме, следует использовать имя "NtSetEvent" вместо "ZwSetEvent".
 
Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP
целевая платформа Всеобщий
заголовка ntifs.h (include Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

См. также

IoCreateNotificationEvent

IoCreateSynchronizationEvent

KeClearEvent

KeResetEvent

KeSetEvent

KeWaitForSingleObject

использование версий собственных системных служб и Zw

ZwClose

ZwCreateEvent

ZwWaitForSingleObject

  • Last updated on