// d3dkmthk.h
NTSTATUS D3DKMTCreateDoorbell(
D3DKMT_CREATE_DOORBELL *unnamedParam1
);
View the official Windows Driver Kit DDI referenceNo description available.
The D3DKMTCreateDoorbell function creates a GPU doorbell for a D3D hardware queue for user-mode work submission.
unnamedParam1[in/out] Pointer to a D3DKMT_CREATE_DOORBELL structure that describes the doorbell to create.
D3DKMTCreateDoorbell returns STATUS_SUCCESS when the OS successfully creates a doorbell for this hardware queue that UMD can use for work submission. Any failure return code means that the doorbell was not created and the UMD can't use it for work submission.
D3DKMTCreateDoorbell creates a doorbell object that is initialized as disconnected. UMD must call D3DKMTConnectDoorbell before using this doorbell to submit commands on the hardware queue.
When UMD calls D3DKMTCreateDoorbell, the OS makes a corresponding call to KMD's DxgkDdiCreateDoorbell callback in which KMD can initialize its doorbell state.
For more information, see User-mode work submission.