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

Weitere Informationen

DXGI-Schnittstellen

IDXGIDeviceSubObject