Compartir a través de


enumeración DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

La enumeración DXGK_QUERYADAPTERINFOTYPE indica el tipo de información a la que debe devolver el controlador de miniporte de pantalla en modo kernel (KMD) en el búfer al que pOutputData apunta cuando se llama a su función DxgkDdiQueryAdapterInfo . Consulte DXGKARG_QUERYADAPTERINFO para obtener más información sobre los tipos que requieren entrada (pInputData).

Syntax

typedef enum _DXGK_QUERYADAPTERINFOTYPE {
  DXGKQAITYPE_UMDRIVERPRIVATE = 0,
  DXGKQAITYPE_DRIVERCAPS = 1,
  DXGKQAITYPE_QUERYSEGMENT = 2,
  DXGKQAITYPE_RESERVED = 3,
  DXGKQAITYPE_QUERYSEGMENT2 = 4,
  DXGKQAITYPE_QUERYSEGMENT3 = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO = 7,
  DXGKQAITYPE_PREFERREDGPUNODE = 8,
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION = 10,
  DXGKQAITYPE_QUERYSEGMENT4 = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE = 12,
  DXGKQAITYPE_GPUMMUCAPS = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION = 16,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES = 19,
  DXGKQAITYPE_DISPLAYID_DESCRIPTOR = 20,
  DXGKQAITYPE_FRAMEBUFFERSAVESIZE = 21,
  DXGKQAITYPE_HARDWARERESERVEDRANGES = 22,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 = 23,
  DXGKQAITYPE_NODEPERFDATA = 24,
  DXGKQAITYPE_ADAPTERPERFDATA = 25,
  DXGKQAITYPE_ADAPTERPERFDATA_CAPS = 26,
  DXGKQAITYPE_GPUVERSION = 27,
  DXGKQAITYPE_DEVICE_TYPE_CAPS = 28,
  DXGKQAITYPE_WDDMDEVICECAPS = 29,
  DXGKQAITYPE_GPUPCAPS = 30,
  DXGKQAITYPE_QUERYTARGETGAMMACAPS = 31,
  DXGKQAITYPE_SCANOUT_CAPS = 33,
  DXGKQAITYPE_PHYSICAL_MEMORY_CAPS = 34,
  DXGKQAITYPE_IOMMU_CAPS = 35,
  DXGKQAITYPE_HARDWARERESERVEDRANGES2 = 36,
  DXGKQAITYPE_NATIVE_FENCE_CAPS = 37,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS = 38,
  DXGKQAITYPE_DIRTYBITTRACKINGCAPS = 39,
  DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS = 40,
  DXGKQAITYPE_SCATTER_RESERVE = 41,
  DXGKQAITYPE_QUERYPAGINGBUFFERINFO,
  DXGKQAITYPE_QUERYSEGMENTCOUNT,
  DXGKQAITYPE_QUERYSEGMENT5,
  DXGKQAITYPE_QUERYMMUCOUNT,
  DXGKQAITYPE_QUERYMMUS,
  DXGKQAITYPE_64BITONLYCAPS,
  DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
} DXGK_QUERYADAPTERINFOTYPE;

Constantes

 
DXGKQAITYPE_UMDRIVERPRIVATE
Valor: 0
Indica una estructura de datos privada definida por su propiedad para el controlador de pantalla.
DXGKQAITYPE_DRIVERCAPS
Valor: 1
El KMD debe rellenar una estructura de DXGK_DRIVERCAPS con sus capacidades de controlador.
DXGKQAITYPE_QUERYSEGMENT
Valor: 2
El KMD debe rellenar una estructura de DXGK_QUERYSEGMENTOUT con su información de segmento de memoria.
DXGKQAITYPE_RESERVED
Valor: 3
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 7.
DXGKQAITYPE_QUERYSEGMENT2
Valor: 4
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 7.
DXGKQAITYPE_QUERYSEGMENT3
Valor: 5
El KMD debe rellenar una estructura de DXGK_QUERYSEGMENTOUT3 con información de segmento de memoria. Se admite a partir de Windows 8.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Valor: 6
El miniporte de pantalla debe proporcionar un valor UINT que especifique el número de componentes de energía que usa. Se admite a partir de Windows 8.
DXGKQAITYPE_POWERCOMPONENTINFO
Valor: 7
El KMD debe rellenar una estructura DXGK_POWER_RUNTIME_COMPONENT con información sobre el componente de energía, donde n es el índice de componente especificado por DXGKARG_QUERYADAPTERINFO.pInputData en una llamada a DxgkDdiQueryAdapterInfo. Se admite a partir de Windows 8.
DXGKQAITYPE_PREFERREDGPUNODE
Valor: 8
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Valor: 9
Reservado para uso del sistema. No use en el controlador. Se admite a partir de Windows 8.1.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Valor: 10
El KMD debe rellenar una estructura de DXGKARG_HISTORYBUFFERPRECISION con información sobre la precisión de los datos del búfer del historial que usa. Se admite a partir de Windows 8.1.
DXGKQAITYPE_QUERYSEGMENT4
Valor: 11
El KMD debe rellenar una estructura de DXGK_QUERYSEGMENTOUT4 para indicar su información de segmento de memoria. Se admite a partir de Windows 10.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Valor: 12
El KMD debe rellenar una estructura de DXGK_MEMORYRANGE con sus intervalos de memoria incorrectos. Se admite a partir de Windows 10.
DXGKQAITYPE_GPUMMUCAPS
Valor: 13
El KMD debe rellenar una estructura de DXGK_GPUMMUCAPS con sus funcionalidades de administración de memoria virtual. Se admite a partir de Windows 10.
DXGKQAITYPE_PAGETABLELEVELDESC
Valor: 14
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Valor: 15
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Valor: 16
Reservado para uso del sistema. No use en el controlador. Esta constante se produce a partir de Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Valor: 17
Se admite a partir de Windows 10, versión 1703. Indica una solicitud para un descriptor de panel integrado donde el búfer de entrada para la consulta será una estructura DXGK_QUERYINTEGRATEDDISPLAYIN y el búfer de salida es una estructura DXGK_QUERYINTEGRATEDDISPLAYOUT .

Aunque esta función aborda un destino, solo los bloqueos del adaptador dxgKrnl se toman en esta llamada, no los bloqueos de dispositivo secundarios. En la práctica, dado que esta llamada se realizará antes de que se exponga el dispositivo secundario, no debe haber llamadas DDI simultáneas que aborden el mismo destino.

NOTA: A diferencia de la mayoría de las llamadas a QueryAdapterInfo, el tamaño del búfer de salida es variable, aunque todavía se conoce de antemano del campo DescriptorLength de la estructura DXGK_INTEGRATED_DISPLAY_CHILD para el identificador de destino. El tamaño del búfer de salida es:
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
Valor: 18
Indica la solicitud de los intervalos de búferes de fotogramas UEFI. Se admite a partir de Windows 10, versión 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
Valor: 19
Se admite a partir de Windows 10, versión 1703. Indica una solicitud de invalidaciones de colorimetría para una presentación externa, donde el búfer de entrada para la consulta será una estructura de DXGK_QUERYCOLORIMETRYOVERRIDESIN , que contiene solo el identificador de destino que se va a abordar y el búfer de salida es una estructura DXGK_COLORIMETRY en la que el controlador escribe invalidaciones para el monitor asociado al destino.

Aunque esta función aborda un destino, solo los bloqueos del adaptador dxgKrnl se toman en esta llamada, no los bloqueos de dispositivo secundarios. Dado que esta llamada se realizará antes de que se exponga el dispositivo secundario, no debe haber llamadas DDI simultáneas que aborden el mismo destino.

El búfer de salida se a cero cuando se pasa al controlador. Si el controlador no tiene invalidaciones para el monitor, debe devolver STATUS_SUCCESS y dejar el búfer de salida en cero. Si el controlador tiene invalidaciones, rellene todos los campos del DXGK_COLORIMETRY para describir las funcionalidades de supervisión, ya que el sistema operativo no aceptará invalidaciones parciales.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
Valor: 20
Indica una solicitud para un descriptor de panel integrado donde el búfer de entrada para la consulta será una estructura de DXGK_QAITARGETIN y el búfer de salida es una estructura DXGK_QUERYINTEGRATEDDISPLAYOUT . Se admite a partir de Windows 10, versión 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Valor: 21
El KMD debe rellenar una estructura de DXGK_FRAMEBUFFERSAVEAREA con el tamaño del búfer de fotogramas para guardar en la memoria del sistema durante las transiciones de energía. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Valor: 22
El KMD debe rellenar una estructura de DXGK_HARDWARERESERVEDRANGES con sus intervalos de memoria reservados de hardware. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Valor: 23
Se admite a partir de Windows 10, versión 1803. Indica una solicitud para un descriptor de panel integrado donde el búfer de entrada para la consulta será una estructura DXGK_QAITARGETIN y el búfer de salida es una estructura DXGK_QUERYINTEGRATEDDISPLAYOUT2 . Esta consulta reemplaza el uso de la consulta de DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR para los controladores WDDM 2.4.

Los dispositivos secundarios TypeIntegratedDisplay se notifican mediante una llamada a DxgkDdiQueryAdapterInfo con el tipo establecido en este valor.
DXGKQAITYPE_NODEPERFDATA
Valor: 24
El KMD debe rellenar una estructura de DXGK_NODE_PERFDATA que representa los datos de rendimiento recopilados por motor de un adaptador a intervalo. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_ADAPTERPERFDATA
Valor: 25
El KMD debe rellenar una estructura de DXGK_ADAPTER_PERFDATA que represente los datos de rendimiento recopilados por adaptador de forma periódica. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Valor: 26
El KMD debe rellenar una estructura de DXGK_ADAPTER_PERFDATACAPS que represente las funcionalidades de datos que son estáticas y consultadas una vez por GPU durante la inicialización. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_GPUVERSION
Valor: 27
El KMD debe rellenar una estructura de DXGK_GPUVERSION utilizada para recopilar la versión del BIOS y el nombre de la arquitectura de GPU una vez durante la inicialización de GPU. Se admite a partir de Windows 10, versión 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Valor: 28
El KMD debe rellenar una estructura de DXGK_DEVICE_TYPE_CAPS que describa el tipo de funcionalidades de un dispositivo. Se admite a partir de Windows 10, versión 1809.
DXGKQAITYPE_WDDMDEVICECAPS
Valor: 29
El KMD debe rellenar una estructura de DXGK_WDDMDEVICECAPS que contenga las funcionalidades de WDDM consultadas por el sistema operativo durante la inicialización del dispositivo. Se admite a partir de Windows 10, versión 1903.
DXGKQAITYPE_GPUPCAPS
Valor: 30
El KMD debe rellenar una estructura de DXGK_GPUPCAPS que contenga las funcionalidades de GPU para un controlador de pantalla en modo kernel. Se admite a partir de Windows 10, versión 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Valor: 31
El KMD debe rellenar una estructura de DXGK_TARGET_GAMMA_CAPS que describa las capacidades gamma del KMD. Se admite a partir de Windows 10, versión 1903.
DXGKQAITYPE_SCANOUT_CAPS
Valor: 33
El KMD debe rellenar una estructura de DXGK_QUERY_SCANOUT_CAPS_OUT que describa las funcionalidades de examen del controlador. Se admite a partir de Windows 10, versión 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Valor: 34
El KMD debe rellenar una estructura de DXGK_PHYSICAL_MEMORY_CAPS que describa las restricciones de memoria física (la dirección física más alta visible) del dispositivo. Se admite a partir de Windows Server 2022 (WDDM 2.9).

Consulte DXGKQAITYPE_IOMMU_CAPS para obtener más información sobre cómo indicar la compatibilidad del controlador con la reasignación lineal de IOMMU.
DXGKQAITYPE_IOMMU_CAPS
Valor: 35
El KMD debe rellenar una estructura DXGK_IOMMU_CAPS que indica que el controlador admite la reasignación lineal de IOMMU. Se admite a partir de Windows Server 2022 (WDDM 2.9). Para indicar la compatibilidad con la reasignación lineal, el controlador también debe informar a Dxgkernel sobre sus restricciones de memoria física a través del límite de DXGKQAITYPE_PHYSICAL_MEMORY_CAPS .

La reasignación lógica solo se puede realizar si el dispositivo hace referencia a ninguna memoria física existente, por lo que la secuencia de llamadas de Dxgkrnl es la siguiente:

* Llame a DxgkDdiAddDevice para todos los adaptadores físicos, para que el controlador pueda recopilar información para todos los adaptadores físicos vinculados.

* Llame a DxgkDdiQueryAdapterInfo con DXGKQAITYPE_PHYSICAL_MEMORY_CAPS y DXGKQAITYPE_IOMMU_CAPS para que pueda crear y conectar el dispositivo a un dominio IOMMU antes de que se pueda acceder a cualquier memoria.

* Llame a DxgkDdiStartDevice para iniciar el dispositivo.
DXGKQAITYPE_HARDWARERESERVEDRANGES2
Valor: 36
DXGKQAITYPE_NATIVE_FENCE_CAPS
Valor: 37
El KMD debe rellenar una estructura de DXGK_NATIVE_FENCE_CAPS que contenga los detalles de compatibilidad del controlador para las barreras nativas de GPU. Se admite a partir de Windows 11, versión 24H2. Para más información, consulte Barreras nativas de GPU.
DXGKQAITYPE_USERMODESUBMISSION_CAPS
Valor: 38
El KMD debe rellenar una estructura de DXGK_USERMODESUBMISSION_CAPS que contenga los detalles de soporte técnico del controlador para el envío de trabajo en modo de usuario. Se admite a partir de Windows 11, versión 24H2. Para obtener más información, vea Envío de trabajo en modo de usuario.
DXGKQAITYPE_DIRTYBITTRACKINGCAPS
Valor: 39
El KMD debe rellenar una estructura de DXGK_DIRTY_BIT_TRACKING_CAPS que contiene los detalles de compatibilidad del controlador para el seguimiento de bits sucio. Se admite a partir de Windows 11, versión 24H2. Para obtener más información, consulte Seguimiento de bits desfasado.
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS
Valor: 40
El KMD debe rellenar una estructura de DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS que contenga los detalles de compatibilidad del controlador para el seguimiento de bits sucios en un segmento de memoria específico. Se admite a partir de Windows 11, versión 24H2. Para obtener más información, consulte Seguimiento de bits desfasado.
DXGKQAITYPE_SCATTER_RESERVE
Valor: 41
El KMD debe rellenar una estructura de DXGK_QUERYSCATTERRESERVEOUT que contenga los detalles de compatibilidad del controlador para la reserva de dispersión. Se admite a partir de Windows 11, versión 24H2. Para más información, consulte Migración en vivo en dispositivos GPU-P.

Comentarios

Dxgkrnl llama a la devolución de llamada DxgkDdiQueryAdapterInfo de KMD para recuperar información de configuración del adaptador de gráficos. El controlador rellena la información solicitada en el búfer al que apunta el miembro pOutputData de la estructura DXGKARG_QUERYADAPTERINFO . Vea cada valor de enumeración para el tipo de estructura que se va a rellenar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Encabezado d3dkmddi.h (incluya D3dkmddi.h)

Consulte también

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo