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 |