Metodo IDXGIAdapter::EnumOutputs (dxgi.h)

  • Articolo

Enumerare gli output della scheda video.

Sintassi

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

Parametri

Output

Tipo: UINT

Indice dell'output.

[out] ppOutput

Tipo: IDXGIOutput**

Indirizzo di un puntatore a un'interfaccia IDXGIOutput nella posizione specificata dal parametro Output .

Valore restituito

Tipo: HRESULT

Codice che indica l'esito positivo o l'errore (vedere DXGI_ERROR). DXGI_ERROR_NOT_FOUND viene restituito se l'indice è maggiore del numero di output.

Se l'adattatore proviene da un dispositivo creato usando D3D_DRIVER_TYPE_WARP, l'adattatore non ha output, quindi DXGI_ERROR_NOT_FOUND viene restituito.

Commenti

Nota Se si chiama questa API in un processo sessione 0, restituisce DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.
 
Quando il metodo EnumOutputs riesce e riempie il parametro ppOutput con l'indirizzo del puntatore all'interfaccia di output, EnumOutputs incrementa il conteggio dei riferimenti dell'interfaccia di output. Per evitare una perdita di memoria, al termine dell'uso dell'interfaccia di output, chiamare il metodo Release per decrerere il conteggio dei riferimenti.

EnumOutputs restituisce prima l'output in cui viene visualizzata la primaria desktop. Questo output corrisponde a un indice pari a zero. EnumOutputs restituisce quindi altri output.

Esempio

Enumerazione degli output

Ecco un esempio di come usare EnumOutputs per enumerare tutti gli output in un adapter:


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

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dxgi.h
Libreria DXGI.lib

Vedi anche

Interfacce DXGI

IDXGIAdapter