IDCompositionDevice::CreateSurface method (dcomp.h)

  • Artikel

Membuat objek permukaan yang dapat diperbarui yang dapat dikaitkan dengan satu atau beberapa visual untuk komposisi.

Sintaks

HRESULT CreateSurface(
  [in]  UINT                 width,
  [in]  UINT                 height,
  [in]  DXGI_FORMAT          pixelFormat,
  [in]  DXGI_ALPHA_MODE      alphaMode,
  [out] IDCompositionSurface **surface
);

Parameter

[in] width

Jenis: UINT

Lebar permukaan, dalam piksel.

[in] height

Jenis: UINT

Tinggi permukaan, dalam piksel.

[in] pixelFormat

Jenis: DXGI_FORMAT

Format piksel permukaan.

[in] alphaMode

Jenis: DXGI_ALPHA_MODE

Format saluran alfa, jika saluran alfa disertakan dalam format piksel. Jenis dapat berupa salah satu dari nilai berikut:

Nilai Makna
DXGI_ALPHA_MODE_UNSPECIFIED Saluran alfa tidak ditentukan. Nilai ini memiliki efek yang sama dengan DXGI_ALPHA_MODE_IGNORE.
DXGI_ALPHA_MODE_PREMULTIPLIED Saluran warna berisi nilai yang telah ditentukan sebelumnya dengan saluran alfa.
DXGI_ALPHA_MODE_IGNORE Saluran alfa harus diabaikan, dan bitmap harus dirender secara buram.

[out] surface

Jenis: IDCompositionSurface**

Objek permukaan yang baru dibuat. Parameter ini tidak boleh NULL.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Permukaan Microsoft DirectComposition adalah array persegi panjang piksel yang dapat dikaitkan dengan visual untuk komposisi.

Objek permukaan yang baru dibuat dalam keadaan tidak diinisialisasi. Meskipun tidak diinisialisasi, permukaan tidak berpengaruh pada komposisi pohon visual. Ini berperilaku persis seperti permukaan yang memiliki 100% piksel transparan.

Untuk menginisialisasi permukaan dengan data piksel, gunakan metode IDCompositionSurface::BeginDraw . Panggilan pertama ke metode ini harus mencakup seluruh area permukaan untuk memberikan nilai awal untuk setiap piksel. Panggilan berikutnya dapat menentukan sub-persegi yang lebih kecil dari permukaan untuk diperbarui.

Permukaan DirectComposition mendukung format piksel berikut:

  • DXGI_FORMAT_B8G8R8A8_UNORM
  • DXGI_FORMAT_R8G8B8A8_UNORM
  • DXGI_FORMAT_R16G16B16A16_FLOAT

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header dcomp.h
Pustaka Dcomp.lib
DLL Dcomp.dll

Lihat juga

IDCompositionDevice

IDCompositionDevice::CreateVirtualSurface