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

Enumera ambos os adaptadores (placas de vídeo) com ou sem saídas.

Sintaxe

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

Parâmetros

Adapter

Tipo: UINT

O índice do adaptador a ser enumerado.

[out] ppAdapter

Tipo: IDXGIAdapter1**

O endereço de um ponteiro para uma interface IDXGIAdapter1 na posição especificada pelo parâmetro Adapter .
Esse parâmetro não deve ser NULL.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, retornará DXGI_ERROR_NOT_FOUND se o índice for maior ou igual ao número de adaptadores no sistema local ou DXGI_ERROR_INVALID_CALL se o parâmetro ppAdapter for NULL.

Comentários

Esse método não tem suporte do DXGI 1.0, que foi enviado no Windows Vista e no Windows Server 2008. O suporte ao DXGI 1.1 é necessário, que está disponível no Windows 7, windows server 2008 R2 e como uma atualização para o Windows Vista com Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).

Quando você cria uma fábrica, a fábrica enumera o conjunto de adaptadores que estão disponíveis no sistema. Portanto, se você alterar os adaptadores em um sistema, deverá destruir e recriar o objeto IDXGIFactory1 . O número de adaptadores em um sistema muda quando você adiciona ou remove um cartão de vídeo ou encaixa ou desencaixa um laptop.

Quando o método EnumAdapters1 é bem-sucedido e preenche o parâmetro ppAdapter com o endereço do ponteiro para a interface do adaptador, EnumAdapters1 incrementa a contagem de referência da interface do adaptador. Quando terminar de usar a interface do adaptador, chame o método Release para diminuir a contagem de referência antes de destruir o ponteiro.

EnumAdapters1 primeiro retorna o adaptador com a saída na qual o primário da área de trabalho é exibido. Esse adaptador corresponde a um índice de zero. EnumAdapters1 em seguida retorna outros adaptadores com saídas. EnumAdapters1 finalmente retorna adaptadores sem saídas.

Exemplos

Enumerando adaptadores

O exemplo de código a seguir demonstra como enumerar adaptadores usando o 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

Confira também

DXGI Interfaces

IDXGIFactory1