DXGK_QUERYADAPTERINFOTYPE enumeration

The DXGK_QUERYADAPTERINFOTYPE enumeration indicates the type of information to retrieve.

Syntax


typedef enum _DXGK_QUERYADAPTERINFOTYPE { 
  DXGKQAITYPE_UMDRIVERPRIVATE                   = 0,
  DXGKQAITYPE_DRIVERCAPS                        = 1,
  DXGKQAITYPE_QUERYSEGMENT                      = 2,
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7)
  DXGKQAITYPE_ALLOCATIONGROUP                   = 3,
  DXGKQAITYPE_QUERYSEGMENT2                     = 4,
#endif 
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
  DXGKQAITYPE_QUERYSEGMENT3                     = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS                = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO                = 7,
  DXGKQAITYPE_PREFERREDGPUNODE                  = 8,
#endif 
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3)
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO          = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION            = 10,
#endif 
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM2_0)
  DXGKQAITYPE_QUERYSEGMENT4                     = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE                = 12,
  DXGKQAITYPE_GPUMMUCAPS                        = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC                = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS               = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION      = 16,
#endif 
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM2_2)
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR     = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES             = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES         = 19
} DXGK_QUERYADAPTERINFOTYPE;

Constants

DXGKQAITYPE_UMDRIVERPRIVATE

Indicates private data for the user-mode display driver.

DXGKQAITYPE_DRIVERCAPS

Indicates the driver capabilities in a DXGK_DRIVERCAPS structure.

DXGKQAITYPE_QUERYSEGMENT

Indicates memory-segment information in a DXGK_QUERYSEGMENTOUT structure.

DXGKQAITYPE_ALLOCATIONGROUP

Reserved for system use. Do not use in your driver. Note that this constant occurs starting with Windows 7.

DXGKQAITYPE_QUERYSEGMENT2

Reserved for system use. Do not use in your driver. Note that this constant occurs starting with Windows 7.

DXGKQAITYPE_QUERYSEGMENT3

Indicates memory-segment information in a DXGK_QUERYSEGMENTOUT3 structure.

Supported starting with Windows 8.

DXGKQAITYPE_NUMPOWERCOMPONENTS

Indicates the number of power components used by the display miniport driver. For more information, see Remarks.

Supported starting with Windows 8.

DXGKQAITYPE_POWERCOMPONENTINFO

Indicates information about power components used by the display miniport driver. For more information, see Remarks.

Supported starting with Windows 8.

DXGKQAITYPE_PREFERREDGPUNODE

Reserved for system use. Do not use in your driver.

Supported starting with Windows 8.

DXGKQAITYPE_POWERCOMPONENTPSTATEINFO

Reserved for system use. Do not use in your driver.

Supported starting with Windows 8.1.

DXGKQAITYPE_HISTORYBUFFERPRECISION

Indicates info about the precision of history buffer data used by the display miniport driver. For more information, see Remarks.

Supported starting with Windows 8.1.

DXGKQAITYPE_QUERYSEGMENT4

Indicates memory-segment information in a DXGK_QUERYSEGMENTOUT4 structure.

Supported starting with Windows 10.

DXGKQAITYPE_SEGMENTMEMORYSTATE

Indicates bad memory ranges in a DXGK_MEMORYRANGE structure.

Supported starting with Windows 10.

DXGKQAITYPE_GPUMMUCAPS

Indicates physical adapter GPU capabilities.

Supported starting with Windows 10.

DXGKQAITYPE_PAGETABLELEVELDESC

Reserved for system use. Do not use in your driver.

DXGKQAITYPE_PHYSICALADAPTERCAPS

Reserved for system use. Do not use in your driver.

DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION

Reserved for system use. Do not use in your driver.

DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR

Indicates a request for an integrated panel descriptor where the input buffer to the query will be a DXGK_QUERYINTEGRATEDDISPLAYIN structure and the output buffer is a DXGK_QUERYINTEGRATEDDISPLAYOUT structure.

Although this function addresses a target, only DxgKrnl adapter locks are taken over this call, not child device locks. In practice, since this call will be made before the child device is exposed, there should be no concurrent DDI calls which address the same target.

Note  Unlike most QueryAdapterInfo calls, the output buffer size is variable although it is still known in advance from the DescriptorLength field of the DXGK_INTEGRATED_DISPLAY_CHILD structure for the target id. The size of the output buffer is: DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor )
 
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES

Indicates request for the UEFI frame buffer ranges.

DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES

Indicates a request for colorimetry overrides for an external display where the input buffer to the query will be a DXGK_QUERYCOLORIMETRYOVERRIDESIN structure, containing only the target id being addressed and the output buffer is a DXGK_COLORIMETRY structure into which the driver writes overrides for the monitor attached to the target.

Although this function addresses a target, only DxgKrnl adapter locks are taken over this call, not child device locks. Since this call will be made before the child device is exposed, there should be no concurrent DDI calls which address the same target.

The output buffer is zeroed when passed to the driver. If the driver has no overrides for the monitor, it should return STATUS_SUCCESS and leave the output buffer zeroed. If the driver has overrides, it fill in all fields of the DXGK_COLORIMETRY to describe the monitor capabilities as the OS will not accept partial overrides.

Remarks

The display miniport driver must fill the buffer pointed to by the pOutputData member of the DXGKARG_QUERYADAPTERINFO structure as follows:

Value of DXGKARG_QUERYADAPTERINFO.TypeContents of output buffer pointed to by DXGKARG_QUERYADAPTERINFO.pOutputData
DXGKQAITYPE_UMDRIVERPRIVATEProprietary buffer
DXGKQAITYPE_DRIVERCAPSPopulated DXGK_DRIVERCAPS structure
DXGKQAITYPE_QUERYSEGMENTPopulated DXGK_QUERYSEGMENTOUT structure
DXGKQAITYPE_QUERYSEGMENT3Populated DXGK_QUERYSEGMENTOUT3 structure
DXGKQAITYPE_NUMPOWERCOMPONENTSA UINT value that specifies the number of power components used by the display miniport driver
DXGKQAITYPE_POWERCOMPONENTINFOPopulated DXGK_POWER_RUNTIME_COMPONENT structure that provides information about the nth power component, where n is the component index specified by DXGKARG_QUERYADAPTERINFO.pInputData in a call to the DxgkDdiQueryAdapterInfo function
DXGKQAITYPE_HISTORYBUFFERPRECISIONPopulated DXGKARG_HISTORYBUFFERPRECISION structure

 

Requirements

Version

Available starting with Windows Vista.

Header

D3dkmddi.h (include D3dkmddi.h)

See also

DXGK_DRIVERCAPS
DXGK_POWER_RUNTIME_COMPONENT
DXGK_QUERYSEGMENTOUT
DXGK_QUERYSEGMENTOUT3
DXGKARG_HISTORYBUFFERPRECISION
DXGKARG_QUERYADAPTERINFO
DxgkDdiQueryAdapterInfo

 

 

Send comments about this topic to Microsoft

Show: