D3DKMTDestroyDoorbell 関数 (d3dkmthk.h)

  • [アーティクル]

重要

一部の情報はプレリリース製品に関連しており、市販される前に大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

D3DKMTDestroyDoorbell はドアベル オブジェクトを破棄します。

構文

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

パラメーター

unnamedParam1

[入力]ドアベルが破棄されるハードウェア キューを識別する D3DKMT_DESTROY_DOORBELL 構造体へのポインター。

戻り値

D3DKMTDestroyDoorbell は、OS がドアベル オブジェクトを正常に破棄したときにSTATUS_SUCCESSを返します。 hDoorbell が有効なドアベルを指している場合、この呼び出しは常に成功します。それ以外の場合は、STATUS_INVALID_PARAMETERを返します。

注釈

UMD が D3DKMTDestroyDoorbell を呼び出すと、OS によって次の処理が行われます。

  • このドアベルに属する hRingBuffer および hRingBufferControl 割り当てへの参照を削除します。
  • pDoorbellStatusCPUVirtualAddress が指すマッピングを解放します。
  • pDoorbellCPUVirtuslAddress が指すユーザー モードマッピングとカーネルモード マッピングの両方を解放します。
  • KMD の [DxgkDdiDestroyDoorbell] を呼び出して、KMD が物理的なドアベルの位置を切断し、そのドアベル オブジェクトを破棄できるようにします。

UMD は 、D3DKMTDestroyDoorbell を呼び出した後にハンドルを使用しないでください。

要件

要件 値
サポートされている最小のクライアント WIN11_FUTURE
Header d3dkmthk.h

こちらもご覧ください

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell