DXGKDDI_CONNECTDOORBELL回呼函式 （d3dkmddi.h）
重要
某些資訊與發行前版本產品有關，在發行前版本產品可能經過大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。
DxgkDdiConnectDoorbell 連線到硬體佇列 先前建立的門鈴物件。
語法
DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;
NTSTATUS DxgkddiConnectdoorbell(
INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}
參數
pArgs
[in/out]描述要連線之門鈴之 DXGKARG_CONNECTDOORBELL 結構的指標。
傳回值
DxgkDdiConnectDoorbell 如果 KMD 能夠成功將其門鈴物件連接到指定的硬體佇列，就會傳回STATUS_SUCCESS。 此呼叫通常不應該失敗;不過，傳回的失敗碼會來自 GPU 遺失或停止類型的無法復原案例。
言論
當 UMD 呼叫 D3DKMTConnectDoorbell時，OS 會呼叫 DxgkDdiConnectDoorbell，讓 KMD 可以執行下列動作：
- 提供對應至實體門鈴位置的CPU虛擬位址。
- 在硬體佇列物件、doorbell 實體位址、GPU 排程器等之間建立必要的連線。
從這個 DDI 傳回時，KMD 應該將此實體位址視為保留給這個特定硬體佇列。 不過，OS 對門鈴的實體地址沒有唯一性需求。 也就是說，KMD 可以根據硬體實作，選擇與多個邏輯門鈴/硬體佇列共用相同的實體位址。 例如，某些硬體可能會選擇將相同的實體位址指派給單一硬體內容的所有硬體佇列。 甚至可能有多個邏輯門鈴共用相同的 4KB 實體頁面，但使用頁面內的唯一位移。
如需詳細資訊，請參閱 使用者模式工作提交。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 （WDDM 3.2） |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |