DXGKDDI_CREATECPUEVENT コールバック関数 (d3dkmddi.h)
DXGKDDI_CREATECPUEVENT は、対応する Dxgkrnl オブジェクトのカーネル モード ドライバー (KMD) CPU イベント オブジェクトを作成します。
構文
DXGKDDI_CREATECPUEVENT DxgkddiCreatecpuevent;
NTSTATUS DxgkddiCreatecpuevent(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATECPUEVENT pArgs
)
{...}
パラメーター
hAdapter
[in]ディスプレイ アダプターに関連付けられている KMD コンテキストへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGKDDI_ADD_DEVICE 関数の出力パラメーター ミニポートDeviceContext で Dxgkrnl を するこのハンドルを提供しました。
pArgs
[入力/出力]追加のパラメーターを持つ DXGKARG_CREATECPUEVENT 構造体へのポインター。
戻り値
DXGKDDI_CREATECPUEVENT は成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.hで定義されているエラー コードの 1 つを返します。
備考
KMD CPU イベント同期オブジェクトは、デバイス オブジェクト (hKmdDevice) にリンクされます。 デバイス オブジェクトが破棄されると、Dxgkrnl は、関連付けられているすべての KMD CPU イベント同期オブジェクトを DXGKDDI_DESTROYCPUEVENT呼び出すことによって破棄します。
KMD は、DXGKCB_SIGNALEVENT を呼び出し、hDxgCpuEvent ハンドルを指定することで、イベントを通知できます。
CPU イベント オブジェクトの有効期間は、KMD のデバイスの有効期間に依存しません。つまり、デバイスが破棄された後にオブジェクトが破棄される可能性があります。 hKmdDevice が渡されるため、ドライバーは KMD プロセス オブジェクト (DXGKDDI_CREATEPROCESSによって作成) を CPU イベント オブジェクトに関連付けることができます。
詳細については、「KMD からの CPU イベントのシグナル通知」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 バージョン 21H2 (WDDM 3.0) |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |