IDXGIOutput::GetDisplaySurfaceData-Methode (dxgi.h)

[Ab Direct3D 11.1 wird empfohlen, GetDisplaySurfaceData nicht mehr zu verwenden, um die aktuelle Anzeigeoberfläche abzurufen. Verwenden Sie stattdessen IDXGIOutput1::GetDisplaySurfaceData1, das den Stereoanzeigemodus unterstützt.]

Ruft eine Kopie der aktuellen Anzeigeoberfläche ab.

Syntax

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Parameter

[in] pDestination

Typ: IDXGISurface*

Ein Zeiger auf eine Zieloberfläche (siehe IDXGISurface).

Rückgabewert

Typ: HRESULT

Gibt einen der DXGI_ERROR Werte zurück.

Hinweise

IDXGIOutput::GetDisplaySurfaceData kann nur aufgerufen werden, wenn sich eine Ausgabe im Vollbildmodus befindet. Wenn die Methode erfolgreich ist, füllt DXGI die Zieloberfläche aus.

Verwenden Sie IDXGIOutput::GetDesc , um die Größe (Breite und Höhe) der Ausgabe zu bestimmen, wenn Sie Speicherplatz für die Zieloberfläche zuordnen möchten. Dies gilt unabhängig von der Zielmonitorrotation. Eine von einer Grafikkomponente (z. B. Direct3D 10) erstellte Zieloberfläche muss mit DER CPU-Schreibberechtigung erstellt werden (siehe D3D10_CPU_ACCESS_WRITE). Andere Oberflächen sollten mit cpu-Lese-/Schreibberechtigung erstellt werden (siehe D3D10_CPU_ACCESS_READ_WRITE). Diese Methode ändert die Oberflächendaten an die Zieloberfläche (Strecken, Verkleinern, Format konvertieren, drehen). Das Dehnungs- und Verkleinern erfolgt mit punktbasierter Stichprobenentnahme.

Anforderungen

Zielplattform	Windows
Kopfzeile	dxgi.h
Bibliothek	DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIOutput