D3DDDI_DOORBELLSTATUS enumeration (d3dukmdt.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 D3DDDI_DOORBELLSTATUS enumeration indicates the status of a doorbell object.

Syntax

typedef enum _D3DDDI_DOORBELLSTATUS {
  D3DDDI_DOORBELLSTATUS_CONNECTED,
  D3DDDI_DOORBELLSTATUS_CONNECTED_NOTIFY_KMD,
  D3DDDI_DOORBELLSTATUS_DISCONNECTED_RETRY,
  D3DDDI_DOORBELLSTATUS_DISCONNECTED_ABORT
} D3DDDI_DOORBELLSTATUS;

Constants

 
D3DDDI_DOORBELLSTATUS_CONNECTED
Indicates that the doorbell object is successfully connected to a hardware queue and ready for work submission.
D3DDDI_DOORBELLSTATUS_CONNECTED_NOTIFY_KMD
Indicates that the doorbell object is connected; however, after every new work submission and doorbell ring, UMD should notify KMD by calling D3DKMTNotifyWorkSubmission.
D3DDDI_DOORBELLSTATUS_DISCONNECTED_RETRY
Indicates that the doorbell can't be connected at this time, but UMD should retry to connect it.
D3DDDI_DOORBELLSTATUS_DISCONNECTED_ABORT
Indicates that the doorbell won't be connected and UMD can't use this hardware queue for work submission. This failure typically implies a nonrecoverable scenario such as a GPU reset or stopped adapter.

Remarks

For more information, see User-mode work submission.

Requirements

Requirement Value
Minimum supported client Windows 11, version 24H2 (WDDM 3.2)
Header d3dukmdt.h

See also

DXGKARG_CONNECTDOORBELL

DXGKARG_DISCONNECTDOORBELL

DxgkDdiConnectDoorbell

DxgkDdiDisconnectDoorbell