IDXGIDevice::CreateSurface-Methode (dxgi.h)

Artikel
08/23/2023

Gibt eine Oberfläche zurück. Diese Methode wird intern verwendet und sollte nicht direkt in Ihrer Anwendung aufgerufen werden.

Syntax

HRESULT CreateSurface(
  [in]           const DXGI_SURFACE_DESC    *pDesc,
                 UINT                       NumSurfaces,
                 DXGI_USAGE                 Usage,
  [in, optional] const DXGI_SHARED_RESOURCE *pSharedResource,
  [out]          IDXGISurface               **ppSurface
);

Parameter

[in] pDesc

Typ: const DXGI_SURFACE_DESC*

Ein Zeiger auf eine DXGI_SURFACE_DESC Struktur, die die Oberfläche beschreibt.

NumSurfaces

Typ: UINT

Die Anzahl der zu erstellenden Oberflächen.

Usage

Typ: DXGI_USAGE

Ein DXGI_USAGE Flag, das angibt, wie die Oberfläche verwendet werden soll.

[in, optional] pSharedResource

Typ: const DXGI_SHARED_RESOURCE*

Ein optionaler Zeiger auf eine DXGI_SHARED_RESOURCE-Struktur , die freigegebene Ressourceninformationen zum Öffnen von Ansichten solcher Ressourcen enthält.

[out] ppSurface

Typ: IDXGISurface**

Die Adresse eines IDXGISurface-Schnittstellenzeigers auf die erste erstellte Oberfläche.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlercode. Eine Liste der Fehlercodes finden Sie unter DXGI_ERROR.

Hinweise

Die CreateSurface-Methode erstellt einen Puffer zum Austauschen von Daten zwischen mindestens einem Gerät. Es wird intern verwendet, und Sie sollten es nicht direkt aufrufen.

Die Runtime erstellt automatisch eine IDXGISurface-Schnittstelle , wenn sie ein Direct3D-Ressourcenobjekt erstellt, das eine Oberfläche darstellt. Beispielsweise erstellt die Runtime eine IDXGISurface-Schnittstelle , wenn id3D11Device::CreateTexture2D oder ID3D10Device::CreateTexture2D aufgerufen wird , 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.