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 |