IDXGIDevice::CreateSurface method (dxgi.h)

Artikel
08/23/2023

Mengembalikan permukaan. Metode ini digunakan secara internal dan Anda tidak boleh memanggilnya langsung di aplikasi Anda.

Sintaks

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

Jenis: const DXGI_SURFACE_DESC*

Penunjuk ke struktur DXGI_SURFACE_DESC yang menggambarkan permukaan.

NumSurfaces

Jenis: UINT

Jumlah permukaan yang akan dibuat.

Usage

Jenis: DXGI_USAGE

Bendera DXGI_USAGE yang menentukan bagaimana permukaan diharapkan digunakan.

[in, optional] pSharedResource

Jenis: const DXGI_SHARED_RESOURCE*

Penunjuk opsional ke struktur DXGI_SHARED_RESOURCE yang berisi informasi sumber daya bersama untuk membuka tampilan sumber daya tersebut.

[out] ppSurface

Jenis: IDXGISurface**

Alamat penunjuk antarmuka IDXGISurface ke permukaan pertama yang dibuat.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil; kode kesalahan sebaliknya. Untuk daftar kode kesalahan, lihat DXGI_ERROR.

Keterangan

Metode CreateSurface membuat buffer untuk bertukar data antara satu atau beberapa perangkat. Ini digunakan secara internal, dan Anda tidak boleh langsung memanggilnya.

Runtime secara otomatis membuat antarmuka IDXGISurface saat membuat objek sumber daya Direct3D yang mewakili permukaan. Misalnya, runtime membuat antarmuka IDXGISurface saat memanggil ID3D11Device::CreateTexture2D atau ID3D10Device::CreateTexture2D untuk membuat tekstur 2D. Untuk mengambil antarmuka IDXGISurface yang mewakili permukaan tekstur 2D, panggil ID3D11Texture2D::QueryInterface atau ID3D10Texture2D::QueryInterface. Dalam panggilan ini, Anda harus meneruskan pengidentifikasi IDXGISurface. Jika tekstur 2D hanya memiliki satu tingkat peta MIP dan tidak terdiri dari array tekstur, QueryInterface berhasil dan mengembalikan penunjuk ke penunjuk antarmuka IDXGISurface . Jika tidak, QueryInterface gagal dan tidak mengembalikan pointer ke IDXGISurface.