IDXGISurface1-Schnittstelle (dxgi.h)

Die IDXGISurface1-Schnittstelle erweitert idXGISurface , indem sie Unterstützung für die Verwendung der Windows-Grafikgeräteschnittstelle (GDI) zum Rendern auf einer DXGI-Oberfläche (Microsoft DirectX Graphics Infrastructure) hinzufügt.

Vererbung

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

Methoden

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

IDXGISurface1::GetDC Gibt einen Gerätekontext (Device Context, DC) zurück, mit dem Sie mithilfe der Windows-Grafikgeräteschnittstelle (GDI) auf einer DXGI-Oberfläche (Microsoft DirectX Graphics Infrastructure) rendern können.
IDXGISurface1::ReleaseDC Gibt den GDI-Gerätekontext (DC) frei, der der aktuellen Oberfläche zugeordnet ist, und ermöglicht es Ihnen, Direct3D zum Rendern zu verwenden.

Hinweise

Diese Schnittstelle wird von DXGI 1.0, das in Windows Vista und Windows Server 2008 ausgeliefert wurde, nicht unterstützt. DxGI 1.1-Unterstützung ist erforderlich, die unter Windows 7, Windows Server 2008 R2 und als Update auf Windows Vista mit Service Pack 2 (SP2) (KB 971644) und Windows Server 2008 (KB 971512) verfügbar ist.

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 anschließend QueryInterface für das IDXGISurface-Objekt auf, das IDXGIOutput::GetDisplaySurfaceData zurückgibt, um die IDXGISurface1-Schnittstelle abzurufen.

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

Die Runtime erstellt automatisch eine IDXGISurface1-Schnittstelle , wenn sie ein Direct3D-Ressourcenobjekt erstellt, das eine Oberfläche darstellt. Beispielsweise erstellt die Runtime eine IDXGISurface1-Schnittstelle , wenn Sie ID3D11Device::CreateTexture2D oder ID3D10Device::CreateTexture2D aufrufen, um eine 2D-Textur zu erstellen. Um die IDXGISurface1-Schnittstelle abzurufen, die die 2D-Texturoberfläche darstellt, rufen Sie ID3D11Texture2D::QueryInterface oder ID3D10Texture2D::QueryInterface auf. In diesem Aufruf müssen Sie den Bezeichner von IDXGISurface1 ü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 IDXGISurface1-Schnittstellenzeiger zurück. Andernfalls schlägt QueryInterface fehl und gibt den Zeiger nicht auf IDXGISurface1 zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi.h

Weitere Informationen

DXGI-Schnittstellen

IDXGISurface