Metodo IDXGIDevice::CreateSurface (dxgi.h)

Articolo
08/23/2023

Restituisce una superficie. Questo metodo viene usato internamente e non è consigliabile chiamarlo direttamente nell'applicazione.

Sintassi

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

Parametri

[in] pDesc

Tipo: const DXGI_SURFACE_DESC*

Puntatore a una struttura DXGI_SURFACE_DESC che descrive la superficie.

NumSurfaces

Tipo: UINT

Numero di superfici da creare.

Usage

Tipo: DXGI_USAGE

Flag di DXGI_USAGE che specifica la modalità di utilizzo della superficie.

[in, optional] pSharedResource

Tipo: const DXGI_SHARED_RESOURCE*

Puntatore facoltativo a una struttura DXGI_SHARED_RESOURCE contenente informazioni sulle risorse condivise per l'apertura di visualizzazioni di tali risorse.

[out] ppSurface

Tipo: IDXGISurface**

Indirizzo di un puntatore dell'interfaccia IDXGISurface alla prima superficie creata.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo; codice di errore in caso contrario. Per un elenco di codici di errore, vedere DXGI_ERROR.

Commenti

Il metodo CreateSurface crea un buffer per scambiare dati tra uno o più dispositivi. Viene usato internamente e non è consigliabile chiamarlo direttamente.

Il runtime crea automaticamente un'interfaccia IDXGISurface quando crea un oggetto risorsa Direct3D che rappresenta una superficie. Ad esempio, il runtime crea un'interfaccia IDXGISurface quando chiama ID3D11Device::CreateTexture2D o ID3D10Device::CreateTexture2D per creare una trama 2D. Per recuperare l'interfaccia IDXGISurface che rappresenta la superficie trama 2D, chiamare ID3D11Texture2D::QueryInterface o ID3D10Texture2D::QueryInterface. In questa chiamata è necessario passare l'identificatore di IDXGISurface. Se la trama 2D ha solo un singolo livello di mappa MIP e non è costituita da una matrice di trame, QueryInterface riesce e restituisce un puntatore al puntatore dell'interfaccia IDXGISurface . In caso contrario, QueryInterface non riesce e non restituisce il puntatore a IDXGISurface.