METODE IDCompositionDevice2::CreateSurface (dcomp.h)

Artikel
02/26/2024

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. Dibatasi oleh tingkat fitur perangkat penyajian yang diteruskan pada saat perangkat DirectComposition dibuat.

[in] height

Jenis: UINT

Tinggi permukaan, dalam piksel. Dibatasi oleh tingkat fitur perangkat penyajian yang diteruskan pada saat perangkat DirectComposition dibuat.

[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.

Nilai kembali

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 dan IDCompositionSurface::EndDraw . Panggilan pertama ke metode ini harus mencakup seluruh area permukaan untuk memberikan nilai awal untuk setiap piksel. Panggilan berikutnya dapat menentukan sub-persegi panjang permukaan yang lebih kecil untuk diperbarui.

Permukaan DirectComposition mendukung format piksel berikut:

DXGI_FORMAT_B8G8R8A8_UNORM
DXGI_FORMAT_R8G8B8A8_UNORM
DXGI_FORMAT_R16G16B16A16_FLOAT

Persyaratan

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

Lihat juga

IDCompositionDevice2

IDCompositionDevice2::CreateVirtualSurface

Bagikan melalui