IDXGIAdapter::EnumOutputs-Methode (dxgi.h)

Artikel
03/01/2024

Enumerate adapter (Video Karte) Ausgaben.

Syntax

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

Parameter

Output

Typ: UINT

Der Index der Ausgabe.

[out] ppOutput

Typ: IDXGIOutput**

Die Adresse eines Zeigers auf eine IDXGIOutput-Schnittstelle an der durch den Output-Parameter angegebenen Position.

Rückgabewert

Typ: HRESULT

Ein Code, der auf Erfolg oder Fehler hinweist (siehe DXGI_ERROR). DXGI_ERROR_NOT_FOUND wird zurückgegeben, wenn der Index größer als die Anzahl der Ausgaben ist.

Wenn der Adapter von einem Gerät stammt, das mit D3D_DRIVER_TYPE_WARP erstellt wurde, verfügt der Adapter über keine Ausgaben, sodass DXGI_ERROR_NOT_FOUND zurückgegeben wird.

Hinweise

Hinweis Wenn Sie diese API in einem Sitzung 0-Prozess aufrufen, wird DXGI_ERROR_NOT_CURRENTLY_AVAILABLE zurückgegeben.

Wenn die EnumOutputs-Methode erfolgreich ist und den ppOutput-Parameter mit der Adresse des Zeigers auf die Ausgabeschnittstelle auffüllt, erhöht EnumOutputs die Verweisanzahl der Ausgabeschnittstelle. Wenn Sie die Verwendung der Ausgabeschnittstelle abgeschlossen haben, rufen Sie die Release-Methode auf, um einen Speicherverlust zu vermeiden, um die Verweisanzahl zu verringern.

EnumOutputs gibt zuerst die Ausgabe zurück, auf der der primäre Desktop angezeigt wird. Diese Ausgabe entspricht einem Index von null. EnumOutputs gibt dann andere Ausgaben zurück.

Beispiele

Aufzählen von Ausgaben

Hier sehen Sie ein Beispiel für die Verwendung von EnumOutputs , um alle Ausgaben eines Adapters aufzulisten:


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

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIAdapter

Freigeben über