Compartir a través de


estructura D3DKMT_ENUMADAPTERS3 (d3dkmthk.h)

La estructura D3DKMT_ENUMADAPTERS3 proporciona información sobre los adaptadores del sistema.

Sintaxis

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

Miembros

[in] Filter

Unión D3DKMT_ENUMADAPTERS_FILTER que contiene marcas de filtro para la enumeración. La estructura de Filtro puede ser un OR bit a bit de los valores siguientes. Vea Comentarios para obtener más información.

Valor Significado
IncludeComputeOnly Cuando se establece, enumera los adaptadores computeOnly.
IncludeDisplayOnly Cuando se establece, enumere adaptadores DisplayOnly.
IncludeVirtualGpuOnly Cuando se establece, enumere los adaptadores de GPU-P. Estos adaptadores están diseñados para usarse solo dentro de máquinas virtuales. Un controlador establece el límite DXGK_DRIVERCAPS::MiscCaps.VirtualGpuOnly para estos adaptadores para evitar su enumeración en el sistema operativo host. Disponible a partir de Windows 11, versión 24H2 (WDDM 3.2).
Reservado Reservado; no use.

[in/out] NumAdapters

Número de adaptadores.

En la entrada, NumAdapters especifica cuántos adaptadores se pueden devolver en la matriz vacía pAdapters. Los valores devueltos posibles para NumAdapters son:

  • Cuando pAdapters es correcto, NumAdapters contiene cuántos adaptadores se devolvieron en la matriz pAdapters de .
  • Si la devolución es correcta cuando pAdapters es null, NumAdapters contiene el número máximo de adaptadores admitidos.
  • Cuando pAdapters no es NULL, NumAdapters no está definido.

[out] pAdapters

Matriz opcional de D3DKMT_ADAPTERINFO estructuras en las que se va a recibir información para cada adaptador.

Observaciones

Los adaptadores se seguirán enumerando si no hay marcas establecidas en Filtro, pero D3DKMTEnumAdapters3 enumerará menos adaptadores que D3DKMTEnumAdapters2. En concreto, D3DKMTEnumAdapters3:

  • Deje los adaptadores computeOnly de la enumeración predeterminada para evitar interrumpir las aplicaciones.
  • Deje los adaptadores de DisplayOnly de la enumeración predeterminada.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 2004
encabezado de d3dkmthk.h

Consulte también

D3DKMT_ADAPTERINFO

D3DKMTEnumAdapters3

PFND3DKMT_ENUMADAPTERS3