DwmRegisterThumbnail

送信先ウィンドウとソースウィンドウの間に Desktop Window Manager (DWM) サムネイル関係を作成する。

DwmRegisterThumbnail hwndDestination, hwndSource, phThumbnailId

hwndDestination : [intptr] DWM サムネイルを使用するウィンドウのハンドル。送信先ウィンドウハンドルにトップレベルウィンドウ以外のものを設定すると、戻り値は E_INVALIDARG となる。
hwndSource : [intptr] サムネイルソースとして使用するウィンドウのハンドル。ソースウィンドウハンドルにトップレベルウィンドウ以外のものを設定すると、戻り値は E_INVALIDARG となる。
phThumbnailId : [var] 関数が正常に戻ったとき、DWM サムネイルの登録を表すハンドルへのポインタ。

(プラグイン / モジュール : dwmapi.dll)

解説

送信先ウィンドウとソースウィンドウの間に Desktop Window Manager (DWM) サムネイル関係を作成する。

[戻り値]
関数が成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

[備考]
DWM サムネイル関係を登録してもデスクトップコンポジションは変更されない。サムネイルの位置決めについては
DwmUpdateThumbnailProperties 関数のドキュメントを参照。hwndDestination
で指定するウィンドウは、デスクトップウィンドウそのものか、DwmRegisterThumbnail
を呼び出しているプロセスが所有するものである必要がある。これは、アプリケーションが他のアプリケーションのコンテンツに影響を与えるのを防ぐためである。この関数で取得したサムネイル登録ハンドルはグローバルに一意ではないが、プロセス内では一意である。サムネイルの登録解除には
DwmUnregisterThumbnail 関数を呼び出す。これは関係を登録したプロセス内で行う必要がある。

情報