ZwSetEvent 関数 (ntifs.h)

[アーティクル]
03/05/2024

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 関数の呼び出しがユーザーモードで行われる場合は、"ZwSetEvent" ではなく "NtSetEvent" という名前を使用する必要があります。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なります。 ルーチンの NtXxx バージョンと ZwXxx バージョン間の関係の詳細については、「Using Nt and Zw Versions of the Native System Services Routines」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL