IDXGIResource1::CreateSubresourceSurface-Methode (dxgi1_2.h)

  • Artikel

Erstellt ein Unterressourcenoberflächenobjekt.

Syntax

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

Parameter

index

Der Index des zu enumerierenden Oberflächenobjekts der Unterressource.

[out] ppSurface

Die Adresse eines Zeigers auf eine IDXGISurface2-Schnittstelle , die das erstellte Unterressourcenoberflächenobjekt an der vom Indexparameter angegebenen Position darstellt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen der folgenden Werte zurück:

  • DXGI_ERROR_INVALID_CALL , wenn der Index außerhalb des Bereichs liegt oder wenn die Unterquelle keine gültige Oberfläche ist.
  • E_OUTOFMEMORY, wenn nicht genügend Arbeitsspeicher zum Erstellen des Surface-Objekts der Unterressource verfügbar ist.
Eine Unterquelle ist eine gültige Oberfläche, wenn die ursprüngliche Ressource eine gültige Oberfläche gewesen wäre, wenn die Arraygröße gleich 1 gewesen wäre.

Hinweise

Unterressourcenoberflächenobjekte implementieren die IDXGISurface2-Schnittstelle , die von IDXGISurface1 und indirekt IDXGISurface erbt. Daher funktionieren die GDI-interoperablen Methoden von IDXGISurface1 , wenn das ursprüngliche Ressourcenschnittstellenobjekt mit dem GDI-interoperable-Flag (D3D11_RESOURCE_MISC_GDI_COMPATIBLE) erstellt wurde.

CreateSubresourceSurface erstellt eine Unterressourcenoberfläche, die auf der Ressourcenschnittstelle basiert, auf der CreateSubresourceSurface aufgerufen wird. Wenn das ursprüngliche Ressourcenschnittstellenobjekt beispielsweise eine 2D-Textur ist, ist die erstellte Unterressourcenoberfläche ebenfalls eine 2D-Textur.

Sie können CreateSubresourceSurface verwenden, um Teile einer Stereoressource zu erstellen, sodass Sie Direct2D entweder im linken oder rechten Teil der Stereoressource verwenden können.

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
Bibliothek Dxgi.lib

Weitere Informationen

IDXGIResource1