METODE IDCompositionDesktopDevice::CreateSurfaceFromHwnd (dcomp.h)
Membuat objek pembungkus yang mewakili rasterisasi jendela berlapis, dan yang dapat dikaitkan dengan visual untuk komposisi.
Sintaks
HRESULT CreateSurfaceFromHwnd(
[in] HWND hwnd,
[out] IUnknown **surface
);
Parameter
[in] hwnd
Handel jendela berlapis untuk membuat pembungkus. Jendela berlapis dibuat dengan menentukan WS_EX_LAYERED saat membuat jendela dengan fungsi CreateWindowEx atau dengan mengatur WS_EX_LAYERED melalui SetWindowLong setelah jendela dibuat.
[out] surface
Objek permukaan komposisi baru. Parameter ini tidak boleh NULL.
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.
Keterangan
Anda dapat menggunakan penunjuk permukaan dalam panggilan ke metode IDCompositionVisual::SetContent untuk mengatur konten satu atau beberapa visual. Setelah mengatur konten, visual menyusun konten jendela berlapis yang ditentukan selama jendela berlapis. Jika jendela tidak ditata, konten jendela menghilang dari output pohon komposisi. Jika jendela kemudian dilapisi ulang, konten jendela muncul kembali selama masih dikaitkan dengan visual. Jika jendela diubah ukurannya, visual yang terpengaruh akan disusam ulang.
Isi jendela tidak di-cache di luar masa pakai jendela. Artinya, jika jendela dihancurkan, visual yang terpengaruh berhenti menyusun jendela.
Jika jendela dipindahkan dari layar atau diubah ukurannya menjadi nol, sistem berhenti menyusun konten visual tersebut. Anda harus menggunakan fungsi DwmSetWindowAttribute dengan bendera DWMWA_CLOAK untuk "menyelubungi" jendela anak berlapis ketika Anda perlu menyembunyikan jendela asli sambil memungkinkan sistem untuk terus menyusun konten visual.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | dcomp.h |