DXGKDDI_DESTROYCPUEVENT コールバック関数 (d3dkmddi.h)

DXGKDDI_DESTROYCPUEVENT は、指定されたカーネルモードドライバー (KMD) CPU オブジェクトを破棄します。

構文

DXGKDDI_DESTROYCPUEVENT DxgkddiDestroycpuevent;

NTSTATUS DxgkddiDestroycpuevent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hKmdCpuEvent
)
{...}

hAdapter

[入力]ディスプレイアダプターに関連付けられている KMD コンテキストを処理します。ディスプレイミニポートドライバーは、DXGKDDI_ADD_DEVICE関数のMiniportDeviceContext 出力パラメーターで Dxgkrnl にこのハンドルを以前に提供しました。

hKmdCpuEvent

[入力]DXGKDDI_CREATECPUEVENT から KMD によって返された KMD CPU イベントオブジェクトハンドル。

DXGKDDI_DESTROYCPUEVENTは 、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、 Ntstatus.h で定義されているエラーコードのいずれかを返します。

Dxgkrnl CPU イベントオブジェクトは、この DDI が呼び出された後は使用できません。ドライバーは、DXGKCB_SIGNALEVENTへのすべての呼び出しと 破棄を同期する必要があります。

OS がこの DDI を呼び出して KMD 同期オブジェクトを破棄することが保証されます。ユーザーモードクライアントが同期オブジェクトを破棄するとき、プロセスが終了したとき、またはアダプターが停止したときに、オブジェクトが破棄される可能性があります。

詳細については、「 KMD からの CPU イベントのシグナル化」を参照してください。