D3DKMTDestroyDoorbell 関数 (d3dkmthk.h)
大事な
一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoft は、ここで提供される情報に関して明示的または黙示的な保証を行いません。
D3DKMTDestroyDoorbell はドアベルを破棄します。
構文
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
パラメーター
unnamedParam1
[in]ドアベルが破棄されるハードウェア キューを識別する 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) |
| ヘッダー | d3dkmthk.h |