DXGKDDI_CREATEDOORBELL回呼函式 (d3dkmddi.h)

發行項
02/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 發出對應的 DxgkDDdiCreateDoorbell 呼叫，讓 KMD 可以初始化其門鈴結構。

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