Método IDXGIFactory::EnumAdapters (dxgi.h)

Enumera los adaptadores (tarjetas de vídeo).

Sintaxis

HRESULT EnumAdapters(
        UINT         Adapter,
  [out] IDXGIAdapter **ppAdapter
);

Parámetros

Adapter

Tipo: UINT

Índice del adaptador que se va a enumerar.

[out] ppAdapter

Tipo: IDXGIAdapter**

Dirección de un puntero a una interfaz IDXGIAdapter en la posición especificada por el parámetro Adapter . Este parámetro no debe ser NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve DXGI_ERROR_NOT_FOUND si el índice es mayor o igual que el número de adaptadores del sistema local o DXGI_ERROR_INVALID_CALL si el parámetro ppAdapter es NULL.

Comentarios

Al crear un generador, el generador enumera el conjunto de adaptadores que están disponibles en el sistema. Por lo tanto, si cambia los adaptadores en un sistema, debe destruir y volver a crear el objeto IDXGIFactory . El número de adaptadores de un sistema cambia al agregar o quitar una tarjeta de pantalla, o acoplar o desacoplar un portátil.

Cuando el método EnumAdapters se realiza correctamente y rellena el parámetro ppAdapter con la dirección del puntero a la interfaz del adaptador, EnumAdapters incrementa el recuento de referencias de la interfaz del adaptador. Cuando termine de usar la interfaz del adaptador, llame al método Release para disminuir el recuento de referencias antes de destruir el puntero.

EnumAdapters devuelve primero el adaptador con la salida en la que se muestra la principal de escritorio. Este adaptador corresponde a un índice de cero. A continuación, EnumAdapters devuelve otros adaptadores con salidas. EnumAdapters finalmente devuelve adaptadores sin salidas.

Ejemplos

Enumerar adaptadores

En el ejemplo de código siguiente se muestra cómo enumerar adaptadores mediante el método EnumAdapters .

UINT i = 0; 
IDXGIAdapter * pAdapter; 
std::vector <IDXGIAdapter*> vAdapters; 
while(pFactory->EnumAdapters(i, &pAdapter) != DXGI_ERROR_NOT_FOUND) 
{ 
	vAdapters.push_back(pAdapter); 
	++i; 
} 

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	dxgi.h
Library	DXGI.lib

Consulte también

DXGI Interfaces

IDXGIFactory