Compartilhar via


D3DKMT_ENUMADAPTERS3 estrutura (d3dkmthk.h)

A estrutura D3DKMT_ENUMADAPTERS3 fornece informações sobre adaptadores no sistema.

Sintaxe

typedef struct _D3DKMT_ENUMADAPTERS3 {
  [in]     D3DKMT_ENUMADAPTERS_FILTER Filter;
  [in/out] ULONG                      NumAdapters;
  [out]    D3DKMT_ADAPTERINFO         *pAdapters;
} D3DKMT_ENUMADAPTERS3;

Membros

[in] Filter

Uma união D3DKMT_ENUMADAPTERS_FILTER que contém sinalizadores de filtro para a enumeração. O struct em Filter pode ser um OR bit a bit dos valores a seguir. Consulte Comentários para obter mais informações.

Valor Significado
IncludeComputeOnly Quando definido, enumera adaptadores ComputeOnly.
IncludeDisplayOnly Quando definido, enumera os adaptadores DisplayOnly.
IncludeVirtualGpuOnly Quando definido, enumera GPU-P adaptadores. Esses adaptadores devem ser usados apenas dentro de máquinas virtuais. Um driver define o DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly limite para esses adaptadores para evitar sua enumeração no sistema operacional host. Disponível a partir do Windows 11, versão 24H2 (WDDM 3.2).
Reservado Reservado; não use.

[in/out] NumAdapters

O número de adaptadores.

Na entrada, NumAdapters especifica quantos adaptadores podem ser retornados na matriz de pAdapters de vazia. Os possíveis valores retornados para NumAdapters são:

  • No retorno bem-sucedido quando pAdapters não for nulo, NumAdapters contém quantos adaptadores foram retornados na matriz de pAdapters .
  • No retorno bem-sucedido quando pAdapters for nulo, NumAdapters contém a contagem máxima de adaptadores com suporte.
  • No retorno com falha quando pAdapters não for nulo, NumAdapters é indefinido.

[out] pAdapters

Uma matriz opcional de estruturas de D3DKMT_ADAPTERINFO nas quais receber informações para cada adaptador.

Observações

Os adaptadores ainda serão enumerados se nenhum sinalizador estiver definido em filtro, mas D3DKMTEnumAdapters3 enumerará menos adaptadores do que D3DKMTEnumAdapters2. Especificamente, D3DKMTEnumAdapters3:

  • Deixe de fora os adaptadores ComputeOnly da enumeração padrão para evitar a quebra de aplicativos.
  • Deixe de fora os adaptadores DisplayOnly da enumeração padrão.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 2004
cabeçalho d3dkmthk.h

Consulte também

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3