Метод IDXGIAdapter::EnumOutputs (dxgi.h)

  • Статья

Перечисление выходных данных адаптера (карта видео).

Синтаксис

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

Параметры

Output

Тип: UINT

Индекс выходных данных.

[out] ppOutput

Тип: IDXGIOutput**

Адрес указателя на интерфейс IDXGIOutput в позиции, заданной параметром Output .

Возвращаемое значение

Тип: HRESULT

Код, указывающий на успех или сбой (см . DXGI_ERROR). DXGI_ERROR_NOT_FOUND возвращается, если индекс больше числа выходных данных.

Если адаптер поступил с устройства, созданного с помощью D3D_DRIVER_TYPE_WARP, то адаптер не имеет выходных данных, поэтому возвращается DXGI_ERROR_NOT_FOUND.

Комментарии

Примечание При вызове этого API в процессе сеанса 0 он возвращает DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.
 
Когда метод EnumOutputs завершается успешно и заполняет параметр ppOutput адресом указателя на выходной интерфейс, EnumOutputs увеличивает количество ссылок выходного интерфейса. Чтобы избежать утечки памяти, по завершении работы с интерфейсом вывода вызовите метод Release для уменьшения количества ссылок.

EnumOutputs сначала возвращает выходные данные, на которых отображается основной рабочий стол. Эти выходные данные соответствуют нулевому индексу. Затем EnumOutputs возвращает другие выходные данные.

Примеры

Перечисление выходных данных

Ниже приведен пример использования EnumOutputs для перечисления всех выходных данных адаптера:


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

Требования

Требование Значение
Целевая платформа Windows
Header dxgi.h
Библиотека DXGI.lib

См. также раздел

Интерфейсы DXGI

IDXGIAdapter