ZwSetEvent 関数 (ntifs.h)

[アーティクル]
12/21/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 バージョンの間の関係の詳細については、「ネイティブシステムサービスルーチンの Nt および Zw バージョンの使用を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP
ターゲットプラットフォームの	万国
ヘッダー	ntifs.h (Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

次の方法で共有

ZwSetEvent 関数 (ntifs.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース