D3DKMTCreateDoorbell function (d3dkmthk.h)
Important
Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The D3DKMTCreateDoorbell function creates a GPU doorbell for a D3D hardware queue for user-mode work submission.
Syntax
NTSTATUS D3DKMTCreateDoorbell(
D3DKMT_CREATE_DOORBELL *unnamedParam1
);
Parameters
unnamedParam1
[in/out] Pointer to a D3DKMT_CREATE_DOORBELL structure that describes the doorbell to create.
Return value
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.
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11, version 24H2 (WDDM 3.2) |
| Header | d3dkmthk.h |