DXGK_VIDSCHCAPS structure (d3dkmddi.h)

The DXGK_VIDSCHCAPS structure identifies the graphics processing unit (GPU) scheduling capabilities, in bit-field flags, that a driver can support.

Syntax

typedef struct _DXGK_VIDSCHCAPS {
  union {
    struct {
      UINT MultiEngineAware : 1;
      UINT VSyncPowerSaveAware : 1;
      UINT PreemptionAware : 1;
      UINT NoDmaPatching : 1;
      UINT CancelCommandAware : 1;
      UINT No64BitAtomics : 1;
      UINT LowIrqlPreemptCommand : 1;
      UINT HwQueuePacketCap : 4;
      UINT NativeGpuFence : 1;
#if ...
      UINT Reserved : 20;
#elif
      UINT Reserved : 21;
#elif
      UINT Reserved : 25;
#elif
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  };
} DXGK_VIDSCHCAPS;

Members

MultiEngineAware

A UINT value that specifies whether the driver supports the creation and destruction of a device context (through the DxgkDdiCreateContext and DxgkDdiDestroyContext functions) and the use of a device context (through the DxgkDdiPresent and DxgkDdiRender functions). If the driver does not support context creation, for every call to the driver that would pass a handle to a context, the Microsoft DirectX graphics kernel subsystem replaces the handle to the context with a handle to the device.

Setting this member is equivalent to setting the first bit of the 32-bit Value member (0x00000001).

VSyncPowerSaveAware

A UINT value that specifies whether the driver supports vertical-sync power-saving functionality.

If VSyncPowerSaveAware is set to 1 (TRUE), the operating system can save power by disabling and enabling the vertical-sync interrupt that occurs from the usage of some applications. If VSyncPowerSaveAware is set to zero (FALSE), the operating system will never disable the vertical-sync interrupt for applications that might cause the vertical-sync interrupt to occur.

Setting this member is equivalent to setting the second bit of the 32-bit Value member (0x00000002).

Supported starting with Windows Server 2008 and Windows Vista with SP1.

PreemptionAware

A UINT value that specifies whether the driver supports the GPU preemption policy of Windows 8 and later versions of Windows. With this policy, the operating system always issues preemption requests to the GPU before it initiates the **Timeout Detection and Recovery (TDR) process.

If PreemptionAware is set to 1 (TRUE), the driver supports the preemption policy of Windows 8 and later versions of Windows.

If PreemptionAware is set to zero (FALSE), the driver supports the preemption policy of Windows 7. With this policy, the operating system may not issue preemption requests while potentially long running operations are being executed on the GPU. As a result, these GPU requests are not preempted before the TDR process is initiated. This may cause the TDR process to repeatedly reset the GPU which could lead to a system stop error.

Setting this member is equivalent to setting the third bit of the 32-bit Value member (0x00000004).

Supported starting with Windows 8.

NoDmaPatching

A UINT value that specifies whether the driver disables leak detection for DMA buffers that are split into multiple parts. This detection is performed after the driver's DxgkDdiPatch function is called to assign, or patch, physical addresses to each part of the DMA buffer.

If NoDmaPatching is set to 1 (TRUE), the driver disables leak detection, and the behavior of DMA buffer splitting is the same as in Windows 7.

If NoDmaPatching is set to 0 (FALSE), the driver enables leak detection for patched DMA buffer addresses. The operating system performs leak detection before it calls the driver's DxgkDdiPatch function.

Setting this member is equivalent to setting the fourth bit of the 32-bit Value member (0x0000008).

Supported starting with Windows 8.

CancelCommandAware

A UINT value that specifies whether the driver supports cleaning up internal resources (through the DxgkDdiCancelCommand function) after a command is removed from the hardware queue.

If CancelCommandAware is set to 1 (TRUE), the driver supports cleaning up resources associated with a canceled DMA packet. If CancelCommandAware is set to zero (FALSE), the driver does not support cleaning up resources.

Setting this member is equivalent to setting the fifth bit of the 32-bit Value member (0x0000010).

Supported starting with Windows 8.

No64BitAtomics

Supported starting with Windows 10.

LowIrqlPreemptCommand

HwQueuePacketCap

Maximum number of DMA packets allowed to be queued to a node.

NativeGpuFence

Reserved

This member is reserved and should be set to zero.

Value

A member in the union that DXGK_VIDSCHCAPS contains that can hold a 32-bit value that identifies the GPU scheduling capabilities that the driver can support.

Requirements

See also

DXGK_DRIVERCAPS

DxgkDdiCancelCommand

DxgkDdiCreateContext

DxgkDdiDestroyContext

DxgkDdiPatch

DxgkDdiPresent

DxgkDdiRender