IDXGIDevice：：CreateSurface 方法 (dxgi.h)

發行項
08/23/2023

傳回表面。此方法會在內部使用，您不應該直接在應用程式中呼叫此方法。

語法

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

參數

[in] pDesc

類型：const DXGI_SURFACE_DESC*

描述表面之DXGI_SURFACE_DESC 結構的指標。

NumSurfaces

類型： UINT

要建立的介面數目。

Usage

類型： DXGI_USAGE

DXGI_USAGE旗標，指定介面的預期使用方式。

[in, optional] pSharedResource

類型：const DXGI_SHARED_RESOURCE*

DXGI_SHARED_RESOURCE結構的選擇性指標，其中包含開啟這類資源的檢視共用資源資訊。

[out] ppSurface

類型： IDXGISurface**

第一個建立介面之 IDXGISurface 介面指標的位址。

傳回值

類型： HRESULT

如果成功，則傳回S_OK;否則為錯誤碼。如需錯誤碼的清單，請參閱 DXGI_ERROR。

備註

CreateSurface方法會建立緩衝區，以在一或多個裝置之間交換資料。它會在內部使用，您不應該直接呼叫它。

執行時間會在建立代表表面的 Direct3D 資源物件時，自動建立 IDXGISurface 介面。例如，執行時間會在呼叫ID3D11Device：：CreateTexture2D或ID3D10Device：：CreateTexture2D來建立 2D 紋理時，執行時間會建立IDXGISurface介面。若要擷取代表 2D 紋理表面的 IDXGISurface 介面，請呼叫 ID3D11Texture2D：：QueryInterface 或 ID3D10Texture2D：：QueryInterface。在此呼叫中，您必須傳遞 IDXGISurface的識別碼。如果 2D 紋理只有單一 MIP 對應層級，且不包含紋理陣列， QueryInterface 會成功並傳回 IDXGISurface 介面指標的指標。否則， QueryInterface 會失敗，而且不會傳回 IDXGISurface的指標。