Fungsi DCompositionCreateSurfaceHandle (dcomp.h)

Artikel
02/28/2024

Membuat objek permukaan komposisi baru yang dapat terikat ke rantai pertukaran Microsoft DirectX atau buffer swap dan terkait dengan visual.

Sintaks

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

Parameter

[in] desiredAccess

Jenis: DWORD

Akses yang diminta ke objek permukaan komposisi. Jenis dapat berupa salah satu dari nilai berikut:

Nilai	Makna
0x0000L	Tidak ada akses.
COMPOSITIONSURFACE_READ 0x0001L	Akses baca. Hanya untuk penggunaan internal.
COMPOSITIONSURFACE_WRITE 0x0002L	Akses tulis. Hanya untuk penggunaan internal.
COMPOSITIONSURFACE_ALL_ACCESS 0x0003L	Akses baca/tulis. Selalu tentukan bendera ini kecuali saat menduplikasi permukaan dalam proses lain, dalam hal ini atur desiredAccess ke 0.

[in, optional] securityAttributes

Jenis: SECURITY_ATTRIBUTES*

Berisi deskriptor keamanan untuk objek permukaan komposisi, dan menentukan apakah handel objek permukaan komposisi dapat diwariskan ketika proses anak dibuat. Jika parameter ini NULL, objek permukaan komposisi dibuat dengan atribut keamanan default yang memberikan akses baca dan tulis ke proses saat ini, tetapi jangan aktifkan proses turunan untuk mewarisi handel.

[out] surfaceHandle

Jenis: HANDEL*

Handel objek permukaan komposisi baru. 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.

Persyaratan

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

Share via