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 割り当てへの参照を削除します。
- DoorbellStatusCPUVirtualAddress が指すマッピングを解放します。
- DoorbellCPUVirtuslAddress が指すユーザー モード マッピングとカーネル モード マッピングの両方を解放します。
- KMD の [DxgkDdiDestroyDoorbell] を呼び出して、KMD が物理的なドアベルの位置を切断してそのドアベル オブジェクトを破棄できるようにします。
UMD は、D3DKMTDestroyDoorbell を呼び出した後にハンドルを使用しないでください。
詳細については、「 ユーザー モードの作業の送信」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 11バージョン 24H2 (WDDM 3.2) |
| Header | d3dkmthk.h |