DXGK_GPUPCAPS structure (d3dkmddi.h)

A kernel-mode display driver uses the DXGK_GPUPCAPS structure to identify its GPU partitioning (GPU-P) capabilities.

Syntax

typedef struct _DXGK_GPUPCAPS {
  union {
    struct {
      UINT VirtualMachineHibernation : 1;
      UINT HotDriverUpdate : 1;
      UINT LiveMigration : 1;
      UINT ScatterMapReserve : 1;
#if ...
      UINT Reserved : 28;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  } Caps;
} DXGK_GPUPCAPS;

Members

Caps

Union containing the capability flags for the GPU-P device.

Caps.VirtualMachineHibernation

The driver sets this bit if it supports guest hibernation for GPU-P devices. The support for guest hibernation is optional and not required for driver certification. A VM that has hibernation enabled and a GPU-P adapter added will fail to start if the driver doesn't support guest hibernation.

Caps.HotDriverUpdate

The driver sets this bit if it supports hot driver updates for GPU-P devices.

Caps.LiveMigration

The driver sets this bit if it supports live migration for GPU-P devices. Added in Windows 11, version 24H2 (WDDM 3.2).

Caps.ScatterMapReserve

The driver sets this bit if it supports *DxgkDdiSetVirtualGpuResources2, which will be added in a future release. Added in Windows 11, version 24H2 (WDDM 3.2).

Caps.Reserved

Reserved.

Caps.Value

The UINT value that represents the combined bitfields of the GPU-P capabilities.

Remarks

The KMD must fill out these caps in response to a DXGKQAITYPE_GPUPCAPS request. The OS queries for these during device initialization after it calls DxgkDdiStartDevice and only if the adapter supports GPU partitioning.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1903
Header d3dkmddi.h

See also

DXGK_QUERYADAPTERINFOTYPE