Freigeben über

IDXGIOutput1::GetDisplaySurfaceData1-Methode (dxgi1_2.h)

  • Artikel

Kopiert die Anzeigeoberfläche (Frontpuffer) in eine vom Benutzer bereitgestellte Ressource.

Syntax

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Parameter

[in] pDestination

Ein Zeiger auf eine Ressourcenschnittstelle, die die Ressource darstellt, in die GetDisplaySurfaceData1 die Anzeigeoberfläche kopiert.

Rückgabewert

Gibt einen der im Thema DXGI_ERROR beschriebenen Fehlercodes zurück.

Hinweise

GetDisplaySurfaceData1 ähnelt IDXGIOutput::GetDisplaySurfaceData, außer GetDisplaySurfaceData1 nimmt eine IDXGIResource an und IDXGIOutput::GetDisplaySurfaceData nimmt eine IDXGISurface an.

GetDisplaySurfaceData1 gibt einen Fehler zurück, wenn die Eingaberessource keine 2D-Textur (dargestellt durch die ID3D11Texture2D-Schnittstelle ) mit einer Arraygröße (ArraySize-Member der D3D11_TEXTURE2D_DESC-Struktur ) ist, die den Swap chain-Puffern entspricht.

Das ursprüngliche IDXGIOutput::GetDisplaySurfaceData und das aktualisierte GetDisplaySurfaceData1 verhalten sich genau gleich. GetDisplaySurfaceData1 war erforderlich, da Texturen mit einer Arraygröße von gleich 2 (ArraySize = 2) IDXGISurface nicht implementieren.

Sie können GetDisplaySurfaceData1 nur aufrufen, wenn sich eine Ausgabe im Vollbildmodus befindet. Wenn GetDisplaySurfaceData1 erfolgreich ist, füllt es die Zielressource aus.

Verwenden Sie IDXGIOutput::GetDesc , um die Größe (Breite und Höhe) der Ausgabe zu bestimmen, wenn Sie Speicherplatz für die Zielressource zuweisen möchten. Dies gilt unabhängig von der Zielmonitorrotation. Eine Zielressource, die von einer Grafikkomponente (z. B. Direct3D 11) erstellt wurde, muss mit CPU-Schreibberechtigung erstellt werden (siehe D3D11_CPU_ACCESS_WRITE). Andere Oberflächen können mit der CPU-Lese-/Schreibberechtigung (D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE) erstellt werden. GetDisplaySurfaceData1 ändert die Oberflächendaten an die Zielressource (Stretch, Shrink, Convert Format, Rotieren). GetDisplaySurfaceData1 führt die Dehnung und Verkleinerung mit Punktstichproben durch.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi1_2.h
Bibliothek DXGI.lib

Weitere Informationen

IDXGIOutput1