DXGKDDI_CREATEDOORBELL回呼函式 （d3dkmddi.h）
重要
某些資訊與發行前版本產品有關，在發行前版本產品可能經過大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。
OS 會呼叫 KMD 的 DxgkDdiCreateDoorbell 回呼函式，以建立硬體佇列的門鈴。
語法
DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;
NTSTATUS DxgkddiCreatedoorbell(
INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}
參數
pArgs
[in/out]描述門鈴之 DXGKARG_CREATEDOORBELL 結構的指標。
傳回值
DxgkDdiCreateDoorbell 如果 KMD 能夠成功建立指定硬體佇列的門鈴物件，而且 UMD 可以使用此門鈴提交工作，則會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS錯誤碼。 如果 KMD 傳回任何失敗碼，UMD 就無法使用門鈴提交工作。
言論
當UMD呼叫 D3DKMTCreateDoorbell 以建立硬體佇列的門鈴時，OS 會建立對應的 DxgkDdiCreateDoorbell KMD 呼叫，讓 KMD 可以初始化其門鈴結構。
KMD 的 DxgkDdiCreateDoorbell 函式應該只建立並初始化其門鈴數據結構。 它不應該將實體門鈴位置指派給這個門鈴對象，因為這會在後續呼叫 dxgkDdiConnectDoorbell 期間完成。 此延遲指派可確保實體門鈴不會在硬體佇列和門鈴建立期間用到，但只有在 UMD 永不提交命令或稍後開始提交命令時，才會浪費。 如此一來，只有實際需要時，才會使用實體門鈴。
如需詳細資訊，請參閱 使用者模式工作提交。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 （WDDM 3.2） |
| 標頭 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |