METODE IDCompositionDesktopDevice::CreateTargetForHwnd (dcomp.h)

Artikel
08/23/2023

Membuat objek target komposisi yang terikat ke jendela yang diwakili oleh handel jendela yang ditentukan.

Sintaks

HRESULT CreateTargetForHwnd(
  [in]  HWND                hwnd,
        BOOL                topmost,
  [out] IDCompositionTarget **target
);

Parameter

[in] hwnd

Jendela tempat objek target komposisi harus terikat. Parameter ini tidak boleh NULL.

topmost

TRUE jika pohon visual harus ditampilkan di atas anak-anak jendela yang ditentukan oleh parameter hwnd; jika tidak, pohon visual ditampilkan di belakang anak-anak.

[out] target

Objek target komposisi baru. Parameter ini tidak boleh NULL.

Nilai kembali

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

Keterangan

Pohon visual DirectComposition harus terikat ke jendela sebelum apa pun dapat ditampilkan di layar. Jendela dapat berupa jendela tingkat atas atau jendela anak. Dalam kedua kasus, jendela dapat menjadi jendela berlapis, tetapi dalam semua kasus jendela harus termasuk dalam proses panggilan. Jika jendela milik proses yang berbeda, metode ini mengembalikan DCOMPOSITION_ERROR_ACCESS_DENIED.

Ketika konten DirectComposition disusam ke jendela, konten selalu disusam di atas apa pun yang digambar langsung ke jendela tersebut melalui konteks perangkat yang dikembalikan oleh fungsi GetDC , atau dengan panggilan ke metode DirectX Present. Namun, karena aturan kliping jendela berlaku untuk konten DirectComposition, jika jendela memiliki jendela anak, jendela anak tersebut dapat mengklip pohon visual. Parameter paling atas menentukan apakah jendela anak mengklip pohon visual.

Secara konseptual, setiap jendela terdiri dari empat lapisan:

Konten yang digambar langsung ke gagang jendela (ini adalah lapisan terbawah).
Pohon visual DirectComposition opsional.
Isi semua jendela anak, jika ada.
Pohon visual DirectComposition opsional lainnya (ini adalah lapisan paling atas).

Keempat lapisan dipotong ke wilayah jendela yang terlihat.

Paling banyak, hanya dua target komposisi yang dapat dibuat untuk setiap jendela dalam sistem, satu yang paling atas dan satu tidak paling atas. Jika target komposisi sudah terikat ke jendela yang ditentukan pada lapisan yang ditentukan, metode ini gagal. Ketika objek target komposisi dihancurkan, lapisan yang disusurnya tersedia untuk digunakan oleh objek target komposisi baru.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dcomp.h

Lihat juga

IDCompositionDesktopDevice

IDCompositionVisual2

Bagikan melalui