Метод IDXGIFactory1::EnumAdapters1 (dxgi.h)

Перечисляет оба адаптера (видеоадаптеры) с выходными данными или без нее.

Синтаксис

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

Параметры

Adapter

Тип: UINT

Индекс адаптера для перечисления.

[out] ppAdapter

Тип: IDXGIAdapter1**

Адрес указателя на интерфейс IDXGIAdapter1 в позиции, заданной параметром Adapter .
Этот параметр не должен иметь значение NULL.

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

Тип: HRESULT

В случае успешного выполнения возвращает S_OK; В противном случае возвращает DXGI_ERROR_NOT_FOUND , если индекс больше или равен числу адаптеров в локальной системе, или DXGI_ERROR_INVALID_CALL , если параметр ppAdapter имеет значение NULL.

Комментарии

Этот метод не поддерживается DXGI 1.0, который поставляется в Windows Vista и Windows Server 2008. Требуется поддержка DXGI 1.1, которая доступна в Windows 7, Windows Server 2008 R2, а также в качестве обновления до Windows Vista с пакетом обновления 2 (SP2) (KB 971644) и Windows Server 2008 (KB 971512).

При создании фабрики фабрика перечисляет набор адаптеров, доступных в системе. Поэтому при изменении адаптеров в системе необходимо уничтожить и повторно создать объект IDXGIFactory1 . Количество адаптеров в системе изменяется при добавлении или удалении дисплея карта, а также при закреплении или отстыковке ноутбука.

Если метод EnumAdapters1 завершается успешно и заполняет параметр ppAdapter адресом указателя на интерфейс адаптера, EnumAdapters1 увеличивает количество ссылок интерфейса адаптера. Завершив работу с интерфейсом адаптера, вызовите метод Release для уменьшения количества ссылок перед уничтожением указателя.

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

Примеры

Перечисление адаптеров

В следующем примере кода показано, как перечислить адаптеры с помощью метода EnumAdapters1 .

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

Требования

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

Интерфейсы DXGI

IDXGIFactory1