D3DKMTCreateDoorbell function (d3dkmthk.h)

  • Article

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

See also

D3DKMTConnectDoorbell

D3DKMT_CREATE_DOORBELL

DxgkDdiConnectDoorbell

DxgkDdiCreateDoorbell

D3DKMTDestroyDoorbell