Compartilhar via

enumeração DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

  • Artigo

A enumeração DXGK_QUERYADAPTERINFOTYPE indica o tipo de informação que o KMD (driver de miniporto de exibição) do modo kernel deve retornar no buffer para o qual pOutputData aponta quando sua função DxgkDdiQueryAdapterInfo é chamada. Consulte DXGKARG_QUERYADAPTERINFO para obter detalhes sobre os tipos que exigem 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 uma estrutura de dados privada definida por proprietário para o driver de exibição.
DXGKQAITYPE_DRIVERCAPS
Valor: 1
O KMD deve preencher uma estrutura DXGK_DRIVERCAPS com suas funcionalidades de driver.
DXGKQAITYPE_QUERYSEGMENT
Valor: 2
O KMD deve preencher uma estrutura DXGK_QUERYSEGMENTOUT com suas informações de segmento de memória.
DXGKQAITYPE_RESERVED
Valor: 3
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir do Windows 7.
DXGKQAITYPE_QUERYSEGMENT2
Valor: 4
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir do Windows 7.
DXGKQAITYPE_QUERYSEGMENT3
Valor: 5
O KMD deve preencher uma estrutura DXGK_QUERYSEGMENTOUT3 com informações de segmento de memória. Com suporte a partir do Windows 8.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Valor: 6
O miniporto de exibição deve fornecer um valor UINT que especifica o número de componentes de energia que ele usa. Com suporte a partir do Windows 8.
DXGKQAITYPE_POWERCOMPONENTINFO
Valor: 7
O KMD deve preencher uma estrutura DXGK_POWER_RUNTIME_COMPONENT com informações sobre o nºcomponente de energia, em que n é o índice de componente especificado por DXGKARG_QUERYADAPTERINFO.pInputData em uma chamada para DxgkDdiQueryAdapterInfo. Com suporte a partir do Windows 8.
DXGKQAITYPE_PREFERREDGPUNODE
Valor: 8
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir de Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Valor: 9
Reservado para uso do sistema. Não use em seu driver. Com suporte a partir de Windows 8.1.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Valor: 10
O KMD deve preencher uma estrutura DXGKARG_HISTORYBUFFERPRECISION com informações sobre a precisão dos dados do buffer de histórico que ele usa. Com suporte a partir de Windows 8.1.
DXGKQAITYPE_QUERYSEGMENT4
Valor: 11
O KMD deve preencher uma estrutura DXGK_QUERYSEGMENTOUT4 para indicar suas informações de segmento de memória. Com suporte a partir de Windows 10.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Valor: 12
O KMD deve preencher uma estrutura DXGK_MEMORYRANGE com seus intervalos de memória inválidos. Com suporte a partir de Windows 10.
DXGKQAITYPE_GPUMMUCAPS
Valor: 13
O KMD deve preencher uma estrutura de DXGK_GPUMMUCAPS com seus recursos de gerenciamento de memória virtual. Com suporte a partir de Windows 10.
DXGKQAITYPE_PAGETABLELEVELDESC
Valor: 14
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir de Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Valor: 15
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir de Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Valor: 16
Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir de Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Valor: 17
Com suporte a partir do Windows 10, versão 1703. Indica uma solicitação para um descritor de painel integrado em que o buffer de entrada para a consulta será uma estrutura DXGK_QUERYINTEGRATEDDISPLAYIN e o buffer de saída é uma estrutura DXGK_QUERYINTEGRATEDDISPLAYOUT .

Embora essa função resolva um destino, somente bloqueios de adaptador DxgKrnl são tomados por essa chamada, não bloqueios de dispositivo filho. Na prática, como essa chamada será feita antes que o dispositivo filho seja exposto, não deve haver chamadas DDI simultâneas que endereçam o mesmo destino.

OBSERVAÇÃO: ao contrário da maioria das chamadas queryAdapterInfo, o tamanho do buffer de saída é variável, embora ainda seja conhecido com antecedência do campo DescriptorLength da estrutura DXGK_INTEGRATED_DISPLAY_CHILD para a ID de destino. O tamanho do buffer de saída é:
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
Valor: 18
Indica a solicitação para os intervalos de buffer de quadro UEFI. Com suporte a partir do Windows 10, versão 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
Valor: 19
Com suporte a partir do Windows 10, versão 1703. Indica uma solicitação de substituições de colorimetria para uma exibição externa, em que o buffer de entrada para a consulta será uma estrutura DXGK_QUERYCOLORIMETRYOVERRIDESIN , contendo apenas a ID de destino que está sendo endereçada e o buffer de saída é uma estrutura DXGK_COLORIMETRY na qual o driver grava substituições para o monitor anexado ao destino.

Embora essa função resolva um destino, somente bloqueios de adaptador DxgKrnl são tomados por essa chamada, não bloqueios de dispositivo filho. Como essa chamada será feita antes que o dispositivo filho seja exposto, não deve haver chamadas DDI simultâneas que endereçam o mesmo destino.

O buffer de saída é zerado quando passado para o driver. Se o driver não tiver substituições para o monitor, ele deverá retornar STATUS_SUCCESS e deixar o buffer de saída zerado. Se o driver tiver substituições, ele preencherá todos os campos do DXGK_COLORIMETRY para descrever os recursos do monitor, pois o sistema operacional não aceitará substituições parciais.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
Valor: 20
Indica uma solicitação para um descritor de painel integrado em que o buffer de entrada para a consulta será uma estrutura DXGK_QAITARGETIN e o buffer de saída é uma estrutura DXGK_QUERYINTEGRATEDDISPLAYOUT . Com suporte a partir do Windows 10, versão 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Valor: 21
O KMD deve preencher uma estrutura DXGK_FRAMEBUFFERSAVEAREA com o tamanho do buffer de quadros para salvar na memória do sistema durante as transições de energia. Com suporte a partir do Windows 10, versão 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Valor: 22
O KMD deve preencher uma estrutura DXGK_HARDWARERESERVEDRANGES com seus intervalos de memória reservados de hardware. Com suporte a partir do Windows 10, versão 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Valor: 23
Com suporte a partir do Windows 10, versão 1803. Indica uma solicitação para um descritor de painel integrado em que o buffer de entrada para a consulta será uma estrutura DXGK_QAITARGETIN e o buffer de saída é uma estrutura DXGK_QUERYINTEGRATEDDISPLAYOUT2 . Essa consulta substitui o uso da consulta DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR para drivers WDDM 2.4.

Os dispositivos filho TypeIntegratedDisplay são relatados chamando DxgkDdiQueryAdapterInfo com o Tipo definido como esse valor.
DXGKQAITYPE_NODEPERFDATA
Valor: 24
O KMD deve preencher uma estrutura DXGK_NODE_PERFDATA que representa os dados de desempenho coletados por mecanismo de um adaptador em uma base de intervalo. Com suporte a partir do Windows 10, versão 1803.
DXGKQAITYPE_ADAPTERPERFDATA
Valor: 25
O KMD deve preencher uma estrutura DXGK_ADAPTER_PERFDATA que representa os dados de desempenho coletados por adaptador em uma base de intervalo. Com suporte a partir de Windows 10, versão 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Valor: 26
O KMD deve preencher uma estrutura DXGK_ADAPTER_PERFDATACAPS que representa recursos de dados estáticos e consultados uma vez por GPU durante a inicialização. Com suporte a partir de Windows 10, versão 1803.
DXGKQAITYPE_GPUVERSION
Valor: 27
O KMD deve preencher uma estrutura DXGK_GPUVERSION usada para coletar a versão do BIOS e o nome da arquitetura de GPU uma vez durante a inicialização da GPU. Com suporte a partir de Windows 10, versão 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Valor: 28
O KMD deve preencher uma estrutura de DXGK_DEVICE_TYPE_CAPS que descreve o tipo de funcionalidades de um dispositivo. Com suporte a partir de Windows 10, versão 1809.
DXGKQAITYPE_WDDMDEVICECAPS
Valor: 29
O KMD deve preencher uma estrutura DXGK_WDDMDEVICECAPS que contém os recursos do WDDM que são consultados pelo sistema operacional durante a inicialização do dispositivo. Com suporte a partir de Windows 10, versão 1903.
DXGKQAITYPE_GPUPCAPS
Valor: 30
O KMD deve preencher uma estrutura DXGK_GPUPCAPS que contém os recursos de GPU para um driver de exibição no modo kernel. Com suporte a partir de Windows 10, versão 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Valor: 31
O KMD deve preencher uma estrutura DXGK_TARGET_GAMMA_CAPS que descreve as funcionalidades gama do KMD. Com suporte a partir de Windows 10, versão 1903.
DXGKQAITYPE_SCANOUT_CAPS
Valor: 33
O KMD deve preencher uma estrutura de DXGK_QUERY_SCANOUT_CAPS_OUT que descreve os recursos de verificação do driver. Com suporte a partir de Windows 10, versão 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Valor: 34
O KMD deve preencher uma estrutura DXGK_PHYSICAL_MEMORY_CAPS que descreve as restrições de memória física (o endereço físico visível mais alto) do dispositivo. Com suporte a partir do Windows Server 2022 (WDDM 2.9).

Consulte DXGKQAITYPE_IOMMU_CAPS para obter detalhes sobre como indicar o suporte ao driver para remapeamento linear de IOMMU.
DXGKQAITYPE_IOMMU_CAPS
Valor: 35
O KMD deve preencher uma estrutura de DXGK_IOMMU_CAPS que indica que o remapeamento linear de IOMMU tem suporte do driver. Com suporte a partir do Windows Server 2022 (WDDM 2.9). Para indicar suporte para remapeamento linear, o driver também deve informar o Dxgkernel sobre suas restrições de memória física por meio do limite de DXGKQAITYPE_PHYSICAL_MEMORY_CAPS .

O remapeamento lógico só poderá ser feito se nenhuma memória física existente for referenciada pelo dispositivo, portanto, a sequência de chamadas de Dxgkrnl será a seguinte:

* Chame DxgkDdiAddDevice para todos os adaptadores físicos, para que o driver possa coletar informações para todos os adaptadores físicos vinculados.

* Chame DxgkDdiQueryAdapterInfo com DXGKQAITYPE_PHYSICAL_MEMORY_CAPS e DXGKQAITYPE_IOMMU_CAPS para que ele possa criar e anexar o dispositivo a um domínio IOMMU antes que qualquer memória possa ser acessada.

* Chame DxgkDdiStartDevice para iniciar o dispositivo.
DXGKQAITYPE_HARDWARERESERVEDRANGES2
Valor: 36
DXGKQAITYPE_NATIVE_FENCE_CAPS
Valor: 37
O KMD deve preencher uma estrutura DXGK_NATIVE_FENCE_CAPS que contém os detalhes de suporte do driver para cercas de GPU nativas. Com suporte a partir de Windows 11, versão 24H2. Para obter mais informações, consulte Cercas de GPU nativas.
DXGKQAITYPE_USERMODESUBMISSION_CAPS
Valor: 38
O KMD deve preencher uma estrutura DXGK_USERMODESUBMISSION_CAPS que contém os detalhes de suporte do driver para envio de trabalho no modo de usuário. Com suporte a partir de Windows 11, versão 24H2. Para obter mais informações, consulte Envio de trabalho no modo de usuário.
DXGKQAITYPE_DIRTYBITTRACKINGCAPS
Valor: 39
O KMD deve preencher uma estrutura DXGK_DIRTY_BIT_TRACKING_CAPS que contém os detalhes de suporte do driver para sujo acompanhamento de bits. Com suporte a partir de Windows 11, versão 24H2. Para obter mais informações, consulte Rastreamento de bits sujo.
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS
Valor: 40
O KMD deve preencher uma estrutura DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS que contém os detalhes de suporte do driver para sujo rastreamento de bits em um segmento de memória específico. Com suporte a partir de Windows 11, versão 24H2. Para obter mais informações, consulte Rastreamento de bits sujo.
DXGKQAITYPE_SCATTER_RESERVE
Valor: 41
O KMD deve preencher uma estrutura DXGK_QUERYSCATTERRESERVEOUT que contém os detalhes de suporte do driver para a reserva de dispersão. Com suporte a partir de Windows 11, versão 24H2. Para obter mais informações, consulte Migração dinâmica em dispositivos GPU-P.

Comentários

Dxgkrnl chama o retorno de chamada DxgkDdiQueryAdapterInfo do KMD para recuperar informações de configuração do adaptador gráfico. O driver preenche as informações solicitadas no buffer apontado pelo membro pOutputData da estrutura DXGKARG_QUERYADAPTERINFO . Consulte cada valor de enumeração para o tipo de estrutura a ser preenchida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)

Confira também

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo