D3DDDI_CREATEHWQUEUEFLAGS structure (d3dukmdt.h)

The D3DDDI_CREATEHWQUEUEFLAGS structure specifies flags to use when creating a hardware queue.

Syntax

typedef struct _D3DDDI_CREATEHWQUEUEFLAGS {
  union {
    struct {
      UINT DisableGpuTimeout : 1;
      UINT NoBroadcastSignal : 1;
      UINT NoBroadcastWait : 1;
      UINT NoKmdAccess : 1;
      UINT UserModeSubmission : 1;
      UINT NativeProgressFence : 1;
      UINT TestQueue : 1;
      UINT Reserved : 25;
    };
    UINT Value;
  };
} D3DDDI_CREATEHWQUEUEFLAGS;

Members

DisableGpuTimeout

When set, indicates to the OS that the hardware queue being created is expected to submit DMA buffers that can take longer than 2 seconds to complete on the GPU, and consequently GPU timeout should be disabled.

NoBroadcastSignal

When set, indicates to the OS that the hardware queue being created does not have application observable behavior, and it should not participate in D3D12 command queue fence broadcast signal operation. This flag was introduced in Windows 10, version 2004.

NoBroadcastWait

When set, indicates to the OS that the hardware queue being created does not have application observable behavior, and it should not be blocked behind in D3D12 command queue fence wait operation. This flag was introduced in Windows 10, version 2004.

NoKmdAccess

Reserved for system use.

UserModeSubmission

When set, indicates to the OS that the hardware queue being created uses the user-mode submission model. Hardware queues created using this flag can't use the regular kernel-mode work submission path and must rely on the doorbell mechanism for work submission on the queue.

NativeProgressFence

When set, indicates that the DXGKARG_CREATEHWQUEUE::hHwQueueProgressFence handle points to the driver handle of a native GPU fence object previously created using DxgkDdiCreateNativeFence. For more information, see Native GPU fence objects. Available starting with Windows 11, version 24H2.

TestQueue

When set, indicates that the hardware queue being created is a test queue for kernel-mode testing. Available starting with Windows 11, version 24H2.

Reserved

Reserved for system use.

Value

This value can be used to operate over the structure members collectively.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1703 (WDDM 2.2)
Header d3dukmdt.h

See also

DxgkDdiCreateHwQueue