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

  • Artigo

Enumerar saídas do adaptador (vídeo cartão).

Sintaxe

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

Parâmetros

Output

Tipo: UINT

O índice da saída.

[out] ppOutput

Tipo: IDXGIOutput**

O endereço de um ponteiro para uma interface IDXGIOutput na posição especificada pelo parâmetro Output .

Retornar valor

Tipo: HRESULT

Um código que indica êxito ou falha (consulte DXGI_ERROR). DXGI_ERROR_NOT_FOUND será retornado se o índice for maior que o número de saídas.

Se o adaptador veio de um dispositivo criado usando D3D_DRIVER_TYPE_WARP, o adaptador não tem saídas, portanto, DXGI_ERROR_NOT_FOUND é retornado.

Comentários

Nota Se você chamar essa API em um processo de Sessão 0, ela retornará DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.
 
Quando o método EnumOutputs é bem-sucedido e preenche o parâmetro ppOutput com o endereço do ponteiro para a interface de saída, EnumOutputs incrementa a contagem de referência da interface de saída. Para evitar um vazamento de memória, quando você terminar de usar a interface de saída, chame o método Release para diminuir a contagem de referência.

EnumOutputs primeiro retorna a saída na qual o primário da área de trabalho é exibido. Essa saída corresponde a um índice de zero. EnumOutputs retorna outras saídas.

Exemplos

Enumerando saídas

Aqui está um exemplo de como usar EnumOutputs para enumerar todas as saídas em um 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 Valor
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

DXGI Interfaces

IDXGIAdapter