EngMapEvent 関数 (winddi.h)

  • [アーティクル]

EngMapEvent 関数は、ユーザー モード イベント オブジェクトをカーネル モードにマップします。

構文

ENGAPI PEVENT EngMapEvent(
  [in] HDEV   hDev,
  [in] HANDLE hUserObject,
       PVOID  Reserved1,
       PVOID  Reserved2,
       PVOID  Reserved3
);

パラメーター

[in] hDev

イベントに関連付けられている物理デバイスを処理します。 これは、ドライバーの DrvCompletePDEV 関数に hdev パラメーターとして渡される GDI ハンドルです。

[in] hUserObject

マップするユーザー モード イベントを処理します。

Reserved1

システム使用のために予約されており、 NULL に設定する必要があります。

Reserved2

システム使用のために予約されており、 NULL に設定する必要があります。

Reserved3

システム使用のために予約されており、 NULL に設定する必要があります。

戻り値

EngMapEvent は、成功した場合にイベント オブジェクトへのポインターを返します。 それ以外の場合は NULL を返します。

解説

ユーザー イベントのマッピングに成功すると、 EngMapEvent はイベント オブジェクトをシグナル状態に自動的に設定し、できるだけ多くの待機を満たそうとしてから、イベント オブジェクトを非署名状態にリセットします。

マップされたイベントは、アプリケーションがカーネル モードのグラフィックス操作の完了を待機できるメカニズムを提供します。 ディスプレイ ドライバーまたはビデオ ミニポート ドライバーは、イベントがマップされたリソースを使用して完了したときにアプリケーションに通知するため、リソースを使用するようにアプリケーションを解放します。

ディスプレイ ドライバーとミニポート ドライバーは、マップされたイベントを待つことはできませんが、それらを設定またはクリアできます。

ドライバーは、EngMapEvent によって返されるイベント オブジェクトで EngUnmapEvent を呼び出すことによって、独自のクリーンアップを実行することもできます。

要件

   
サポートされている最小のクライアント この関数は、Windows XP 以降で使用できます。
対象プラットフォーム ユニバーサル
Header winddi.h (Winddi.h を含む)
Library Win32k.lib
[DLL] Win32k.sys

関連項目

DrvCompletePDEV

EngUnmapEvent