Fungsi DwmRegisterThumbnail (dwmapi.h)

Artikel
08/14/2024

Membuat hubungan gambar mini Desktop Window Manager (DWM) antara jendela tujuan dan sumber.

Sintaks

HRESULT DwmRegisterThumbnail(
  [in]  HWND        hwndDestination,
  [in]  HWND        hwndSource,
  [out] PHTHUMBNAIL phThumbnailId
);

Parameter

[in] hwndDestination

Handel ke jendela yang akan menggunakan gambar mini DWM. Mengatur handel jendela tujuan ke apa pun selain jenis jendela tingkat atas akan menghasilkan nilai pengembalian E_INVALIDARG.

[in] hwndSource

Handel ke jendela untuk digunakan sebagai sumber gambar mini. Mengatur handel jendela sumber ke apa pun selain jenis jendela tingkat atas akan menghasilkan nilai pengembalian E_INVALIDARG.

[out] phThumbnailId

Penunjuk ke handel yang, ketika fungsi ini berhasil dikembalikan, mewakili pendaftaran gambar mini DWM.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Mendaftarkan hubungan gambar mini DWM tidak akan mengubah komposisi desktop; untuk informasi tentang penempatan gambar mini, lihat dokumentasi untuk fungsi DwmUpdateThumbnailProperties .

Jendela yang ditunjuk oleh hwndDestination harus berupa jendela desktop itu sendiri atau dimiliki oleh proses yang memanggil DwmRegisterThumbnail. Ini diperlukan untuk mencegah aplikasi memengaruhi konten aplikasi lain.

Handel pendaftaran gambar mini yang diperoleh oleh fungsi ini tidak unik secara global tetapi unik untuk prosesnya. Panggil fungsi DwmUnregisterThumbnail untuk membatalkan pendaftaran gambar mini. Ini harus dilakukan dalam proses tempat hubungan terdaftar.

Contoh

Contoh berikut menunjukkan cara mendaftarkan gambar mini desktop.


HRESULT UpdateDesktop(HWND hwnd)
{
	HRESULT hr = S_OK;

	// Register the thumbnail
	HTHUMBNAIL thumbnail = NULL;

	hr = DwmRegisterThumbnail(hwnd, FindWindow(_T("Progman"), NULL), &thumbnail);
	if (SUCCEEDED(hr))
	{
		// Display the thumbnail using DwmUpdateThumbnailProperties
	}
	return hr;	
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	dwmapi.h
Pustaka	Dwmapi.lib
DLL	Dwmapi.dll