DXGK_QUERYADAPTERINFOTYPE enumeração (d3dkmddi.h)

Artigo
02/06/2025

A enumeração DXGK_QUERYADAPTERINFOTYPE indica o tipo de informação que o KMD (driver de miniporto de exibição) no modo kernel deve retornar no buffer que pOutputData aponta para quando sua função DxgkDdiQueryAdapterInfo é chamada. Consulte DXGKARG_QUERYADAPTERINFO para obter detalhes sobre os tipos que exigem entrada (pInputData).

Sintaxe

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 = 42,
  DXGKQAITYPE_QUERYSEGMENTCOUNT = 43,
  DXGKQAITYPE_QUERYSEGMENT5 = 44,
  DXGKQAITYPE_QUERYMMUCOUNT = 45,
  DXGKQAITYPE_QUERYMMUS = 46,
  DXGKQAITYPE_64BITONLYCAPS = 47,
  DXGKQAITYPE_PAGINGPROCESSGPUVASIZE = 48
} 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 de DXGK_DRIVERCAPS com suas funcionalidades de driver.
`DXGKQAITYPE_QUERYSEGMENT` Valor: 2 O KMD deve preencher uma estrutura de 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 de 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 de DXGK_POWER_RUNTIME_COMPONENT com informações sobre o componente nth power, 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 do Windows 8.
`DXGKQAITYPE_POWERCOMPONENTPSTATEINFO` Valor: 9 Reservado para uso do sistema. Não use em seu driver. Com suporte a partir do Windows 8.1.
`DXGKQAITYPE_HISTORYBUFFERPRECISION` Valor: 10 O KMD deve preencher uma estrutura de DXGKARG_HISTORYBUFFERPRECISION com informações sobre a precisão dos dados de buffer de histórico que ele usa. Com suporte a partir do Windows 8.1.
`DXGKQAITYPE_QUERYSEGMENT4` Valor: 11 O KMD deve preencher uma estrutura de DXGK_QUERYSEGMENTOUT4 para indicar suas informações de segmento de memória. Com suporte a partir do Windows 10.
`DXGKQAITYPE_SEGMENTMEMORYSTATE` Valor: 12 O KMD deve preencher uma estrutura de DXGK_MEMORYRANGE com seus intervalos de memória inválidos. Com suporte a partir do Windows 10.
`DXGKQAITYPE_GPUMMUCAPS` Valor: 13 O KMD deve preencher uma estrutura DXGK_GPUMMUCAPS com seus recursos de gerenciamento de memória virtual. Com suporte a partir do Windows 10.
`DXGKQAITYPE_PAGETABLELEVELDESC` Valor: 14 Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir do Windows 10.
`DXGKQAITYPE_PHYSICALADAPTERCAPS` Valor: 15 Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir do Windows 10.
`DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION` Valor: 16 Reservado para uso do sistema. Não use em seu driver. Essa constante ocorre a partir do 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 os bloqueios do adaptador DxgKrnl são tomados sobre 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 os bloqueios do adaptador DxgKrnl são tomados sobre 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 quadro 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 de 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. typeIntegratedDisplay dispositivos filho 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 um intervalo. Com suporte a partir do Windows 10, versão 1803.
`DXGKQAITYPE_ADAPTERPERFDATA` Valor: 25 O KMD deve preencher uma estrutura de DXGK_ADAPTER_PERFDATA que representa os dados de desempenho coletados por adaptador em um intervalo. Com suporte a partir do Windows 10, versão 1803.
`DXGKQAITYPE_ADAPTERPERFDATA_CAPS` Valor: 26 O KMD deve preencher uma estrutura de DXGK_ADAPTER_PERFDATACAPS que representa os recursos de dados que são estáticos e consultados uma vez por GPU durante a inicialização. Com suporte a partir do Windows 10, versão 1803.
`DXGKQAITYPE_GPUVERSION` Valor: 27 O KMD deve preencher uma estrutura de 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 do Windows 10, versão 1803.
`DXGKQAITYPE_DEVICE_TYPE_CAPS` Valor: 28 O KMD deve preencher uma estrutura DXGK_DEVICE_TYPE_CAPS que descreve o tipo de funcionalidades para um dispositivo. Com suporte a partir do Windows 10, versão 1809.
`DXGKQAITYPE_WDDMDEVICECAPS` Valor: 29 O KMD deve preencher uma estrutura de 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 do Windows 10, versão 1903.
`DXGKQAITYPE_GPUPCAPS` Valor: 30 O KMD deve preencher uma estrutura de DXGK_GPUPCAPS que contém os recursos de GPU para um driver de exibição no modo kernel. Com suporte a partir do Windows 10, versão 1903.
`DXGKQAITYPE_QUERYTARGETGAMMACAPS` Valor: 31 O KMD deve preencher uma estrutura de DXGK_TARGET_GAMMA_CAPS que descreve os recursos gama do KMD. Com suporte a partir do 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 do 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 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, Dxgkrnlsequência de chamadas é 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 de DXGK_NATIVE_FENCE_CAPS que contenha os detalhes de suporte do driver para cercas de GPU nativas. Com suporte a partir do 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 de 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 do Windows 11, versão 24H2. Para obter mais informações, consulte de envio de trabalho no modo de usuário.
`DXGKQAITYPE_DIRTYBITTRACKINGCAPS` Valor: 39 O KMD deve preencher uma estrutura de DXGK_DIRTY_BIT_TRACKING_CAPS que contenha os detalhes de suporte do driver para o rastreamento de bits sujo. Com suporte a partir do Windows 11, versão 24H2. Para obter mais informações, consulte de controle de bits sujo .
`DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS` Valor: 40 O KMD deve preencher uma estrutura de DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS que contenha os detalhes de suporte do driver para acompanhamento de bits sujos em um segmento de memória específico. Com suporte a partir do Windows 11, versão 24H2. Para obter mais informações, consulte de controle de bits sujo .
`DXGKQAITYPE_SCATTER_RESERVE` Valor: 41 O KMD deve preencher uma estrutura de DXGK_QUERYSCATTERRESERVEOUT que contenha os detalhes de suporte do driver para a reserva de dispersão. Com suporte a partir do Windows 11, versão 24H2. Para obter mais informações, consulte migração ao vivo em dispositivos GPU-P.
`DXGKQAITYPE_QUERYPAGINGBUFFERINFO` Valor: 42
`DXGKQAITYPE_QUERYSEGMENTCOUNT` Valor: 43
`DXGKQAITYPE_QUERYSEGMENT5` Valor: 44
`DXGKQAITYPE_QUERYMMUCOUNT` Valor: 45
`DXGKQAITYPE_QUERYMMUS` Valor: 46
`DXGKQAITYPE_64BITONLYCAPS` Valor: 47
`DXGKQAITYPE_PAGINGPROCESSGPUVASIZE` Valor: 48 O KMD deve retornar o tamanho do espaço de VA da GPU do processo de paginação, em megabytes. Para obter mais informações, consulte de Notificação de Alocação. Disponível a partir do Windows 11, versão 24H2 (WDDM 3.2).

Observações

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)

Consulte também

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo

Partilhar via