IDXGISurface2-Schnittstelle (dxgi1_2.h)

Die IDXGISurface2-Schnittstelle erweitert die IDXGISurface1-Schnittstelle , indem sie Unterstützung für Unterressourcenoberflächen hinzufügt und ein Handle für eine freigegebene Ressource erhält.

Vererbung

Die IDXGISurface2-Schnittstelle erbt von IDXGISurface1. IDXGISurface2 verfügt auch über folgende Membertypen:

Methoden

Die IDXGISurface2-Schnittstelle verfügt über diese Methoden.

IDXGISurface2::GetResource Ruft die übergeordnete Ressource und den Unterressourcenindex ab, die eine Unterressourcenoberfläche unterstützen.

Hinweise

Ein Bilddatenobjekt ist ein 2D-Speicherabschnitt, der häufig als Oberfläche bezeichnet wird. Um die Oberfläche aus einer Ausgabe abzurufen, rufen Sie IDXGIOutput::GetDisplaySurfaceData auf. Rufen Sie dann QueryInterface für das IDXGISurface-Objekt auf, das IDXGIOutput::GetDisplaySurfaceData zurückgibt, um die IDXGISurface2-Schnittstelle abzurufen.

Jedes Objekt, das IDXGISurface unterstützt, unterstützt auch IDXGISurface2.

Die Runtime erstellt automatisch eine IDXGISurface2-Schnittstelle , wenn sie ein Direct3D-Ressourcenobjekt erstellt, das eine Oberfläche darstellt. Beispielsweise erstellt die Runtime eine IDXGISurface2-Schnittstelle , wenn Sie ID3D11Device::CreateTexture2D aufrufen, um eine 2D-Textur zu erstellen. Um die IDXGISurface2-Schnittstelle abzurufen, die die 2D-Texturoberfläche darstellt, rufen Sie ID3D11Texture2D::QueryInterface auf. In diesem Aufruf müssen Sie den Bezeichner von IDXGISurface2 übergeben. Wenn die 2D-Textur nur eine einzelne MIP-Kartenebene aufweist und nicht aus einem Array von Texturen besteht, ist QueryInterface erfolgreich und gibt einen Zeiger auf den IDXGISurface2-Schnittstellenzeiger zurück. Andernfalls schlägt QueryInterface fehl und gibt den Zeiger nicht auf IDXGISurface2 zurück.

Sie können die IDXGIResource1::CreateSubresourceSurface-Methode aufrufen, um eine IDXGISurface2-Schnittstelle zu erstellen, die auf eine Unterressource einer Stereoressource verweist.

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

Weitere Informationen

DXGI-Schnittstellen

IDXGISurface1