IDXGISurface-Schnittstelle (dxgi.h)
Die IDXGISurface-Schnittstelle implementiert Methoden für Bilddatenobjekte.
Vererbung
Die IDXGISurface-Schnittstelle wird von IDXGIDeviceSubObject abgeleitet.
Methoden
Die IDXGISurface-Schnittstelle verfügt über diese Methoden.
| IDXGISurface::GetDesc Rufen Sie eine Beschreibung der Oberfläche ab. |
| IDXGISurface::Map Rufen Sie einen Zeiger auf die in der Oberfläche enthaltenen Daten ab, und verweigern Sie gpu-Zugriff auf die Oberfläche. |
| IDXGISurface::Unmap Deaktivieren Sie den Zeiger auf die von IDXGISurface::Map abgerufene Oberfläche, und aktivieren Sie den GPU-Zugriff auf die Ressource erneut. |
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.
Runtimes vor Direct3D 12 erstellen automatisch eine IDXGISurface-Schnittstelle , wenn sie ein Direct3D-Ressourcenobjekt erstellen, das eine Oberfläche darstellt. IDXGISurface-Schnittstellen werden in Direct3D 12 nicht unterstützt. Beispielsweise erstellt die Runtime eine IDXGISurface-Schnittstelle , wenn Sie ID3D11Device::CreateTexture2D oder ID3D10Device::CreateTexture2D aufrufen, um eine 2D-Textur zu erstellen. Um die IDXGISurface-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 IDXGISurface ü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 IDXGISurface-Schnittstellenzeiger zurück. Andernfalls schlägt QueryInterface fehl und gibt den Zeiger auf IDXGISurface nicht zurück.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | dxgi.h |