DwmRegisterThumbnail 関数 (dwmapi.h)

[アーティクル]
02/28/2024

変換先ウィンドウとソースウィンドウの間にデスクトップウィンドウマネージャー (DWM) のサムネイル関係を作成します。

構文

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

パラメーター

hwndDestination

DWM サムネイルを使用するウィンドウへのハンドル。宛先ウィンドウハンドルを最上位のウィンドウの種類以外に設定すると、戻り値は E_INVALIDARGになります。

hwndSource

サムネイルソースとして使用するウィンドウへのハンドル。ソースウィンドウハンドルを最上位のウィンドウの種類以外に設定すると、戻り値は E_INVALIDARGになります。

[out] phThumbnailId

この関数が正常に返されるときに、DWM サムネイルの登録を表すハンドルへのポインター。

戻り値

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

注釈

DWM サムネイルリレーションシップを登録すると、デスクトップのコンポジションは変更されません。サムネイルの配置の詳細については、 DwmUpdateThumbnailProperties 関数のドキュメントを参照してください。

hwndDestination によって指定されるウィンドウは、デスクトップウィンドウ自体であるか、DwmRegisterThumbnail を呼び出しているプロセスによって所有されている必要があります。これは、アプリケーションが他のアプリケーションのコンテンツに影響を与えないようにするために必要です。

この関数によって取得されたサムネイル登録ハンドルはグローバルに一意ではありませんが、プロセスに固有です。 DwmUnregisterThumbnail 関数を呼び出して、サムネイルの登録を解除します。これは、リレーションシップが登録されたプロセス内で行う必要があります。

例

次の例では、デスクトップサムネイルを登録する方法を示します。


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;	
}

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	dwmapi.h
Library	Dwmapi.lib
[DLL]	Dwmapi.dll