DXGKDDI_CONNECTDOORBELL回呼函式 (d3dkmddi.h)

發行項
05/23/2024

重要

某些資訊與發行前版本產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

DxgkDdiConnectDoorbell 會將 () 或重新連線至先前建立的門鈴物件至硬體佇列。

語法

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

參數

pArgs

[in/out]描述要連接之門鈴之 DXGKARG_CONNECTDOORBELL 結構的指標。

傳回值

如果 KMD 能夠將其門鈴物件成功連接到指定的硬體佇列，DxgkDDdiConnectDoorbell 會傳回STATUS_SUCCESS。此呼叫通常不應該失敗;不過，傳回的失敗碼會來自 GPU 遺失或停止的無法復原案例類型。

備註

當 UMD 呼叫 D3DKMTConnectDoorbell 時，OS 會呼叫 DxgkDdiConnectDoorbell ，讓 KMD 可以執行下列動作：

提供對應至實體門鈴位置的CPU虛擬位址。
在硬體佇列對象、門鈴物件位址、GPU 排程器等之間建立必要的連線。

從這個 DDI 傳回時，KMD 應該將此實體位址視為保留給這個特定硬體佇列。不過，OS 對門鈴的實體地址沒有唯一性需求。也就是說，KMD 可以根據硬體實作，選擇與多個邏輯門鈴/硬體佇列共用相同的實體位址。例如，某些硬體可能會選擇將相同的實體位址指派給單一硬體內容的所有硬體佇列。即使多個邏輯門鈴共用相同的 4KB 實體頁面，但使用頁面內的唯一位移也一樣。

如需詳細資訊，請參閱使用者模式工作提交。