Método IDXGIAdapter::EnumOutputs (dxgi.h)

Enumerar salidas del adaptador (tarjeta de vídeo).

Sintaxis

HRESULT EnumOutputs(
        UINT        Output,
  [out] IDXGIOutput **ppOutput
);

Parámetros

Output

Tipo: UINT

Índice de la salida.

[out] ppOutput

Tipo: IDXGIOutput**

Dirección de un puntero a una interfaz IDXGIOutput en la posición especificada por el parámetro Output .

Valor devuelto

Tipo: HRESULT

Código que indica éxito o error (consulte DXGI_ERROR). DXGI_ERROR_NOT_FOUND se devuelve si el índice es mayor que el número de salidas.

Si el adaptador procede de un dispositivo creado mediante D3D_DRIVER_TYPE_WARP, el adaptador no tiene salidas, por lo que se devuelve DXGI_ERROR_NOT_FOUND.

Comentarios

Nota Si llama a esta API en un proceso de sesión 0, devuelve DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

 

Cuando el método EnumOutputs se realiza correctamente y rellena el parámetro ppOutput con la dirección del puntero a la interfaz de salida, EnumOutputs incrementa el recuento de referencias de la interfaz de salida. Para evitar una pérdida de memoria, cuando termine de usar la interfaz de salida, llame al método Release para disminuir el recuento de referencias.

EnumOutputs devuelve primero la salida en la que se muestra la principal de escritorio. Esta salida corresponde a un índice de cero. A continuación, EnumOutputs devuelve otras salidas.

Ejemplos

Enumerar salidas

Este es un ejemplo de cómo usar EnumOutputs para enumerar todas las salidas de un adaptador:

UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

Requisitos

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

Consulte también

DXGI Interfaces

IDXGIAdapter