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 |