Método IDXGIFactory1::EnumAdapters1 (dxgi.h)

Enumera ambos adaptadores (tarjetas de vídeo) con o sin salidas.

Sintaxis

HRESULT EnumAdapters1(
        UINT          Adapter,
  [out] IDXGIAdapter1 **ppAdapter
);

Parámetros

Adapter

Tipo: UINT

Índice del adaptador que se va a enumerar.

[out] ppAdapter

Tipo: IDXGIAdapter1**

Dirección de un puntero a una interfaz IDXGIAdapter1 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

DxGI 1.0 no admite este método, que se incluye en Windows Vista y Windows Server 2008. Se requiere compatibilidad con DXGI 1.1, que está disponible en Windows 7, Windows Server 2008 R2 y como actualización de Windows Vista con Service Pack 2 (SP2) (KB 971644) y Windows Server 2008 (KB 971512).

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 IDXGIFactory1 . 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 EnumAdapters1 se realiza correctamente y rellena el parámetro ppAdapter con la dirección del puntero a la interfaz del adaptador, EnumAdapters1 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.

EnumAdapters1 devuelve primero el adaptador con la salida en la que se muestra la principal de escritorio. Este adaptador corresponde a un índice de cero. EnumAdapters1 después devuelve otros adaptadores con salidas. EnumAdapters1 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 EnumAdapters1 .

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

Requisitos

Consulte también

DXGI Interfaces

IDXGIFactory1