DXGKDDI_CREATEDOORBELL回呼函式 (d3dkmddi.h)

發行項
05/23/2024

重要

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

OS 會呼叫 KMD 的 DxgkDdiCreateDoorbell 回呼函式，以建立硬體佇列的門鈴。

語法

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

參數

pArgs

[in/out]描述門鈴 之DXGKARG_CREATEDOORBELL 結構的指標。

傳回值

DxgkDdiCreateDoorbell 會傳回STATUS_SUCCESS如果 KMD 能夠成功為指定的硬體佇列建立其門鈴物件，而且 UMD 可以使用這個門鈴進行工作提交。否則，它會傳回適當的NTSTATUS錯誤碼。如果 KMD 傳回任何失敗碼，UMD 就無法使用門鈴提交工作。

備註

當UMD呼叫 D3DKMTCreateDoorbell 來建立硬體佇列的門鈴時，OS 會對 KMD 進行對應的 DxgkDdiCreateDoorbell 呼叫，讓 KMD 可以初始化其門鈴結構。

KMD 的 DxgkDdiCreateDoorbell 函式應該只建立並初始化其門鈴數據結構。它不應該將實體門鈴位置指派給這個門鈴對象，因為該物件會在後續呼叫 DxgkDdiConnectDoorbell 期間完成。此延遲指派可確保在硬體佇列和門鈴建立期間不會用到實體門鈴，只會浪費在 UMD 永遠不會將命令提交至它或稍後開始提交命令時浪費。如此一來，只有在實際需要時，才會使用實體門鈴。

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