DwmGetWindowAttribute 関数 (dwmapi.h)

  • [アーティクル]

ウィンドウに適用された、指定されたデスクトップ ウィンドウ マネージャー (DWM) 属性の現在の値を取得します。 プログラミング ガイダンスとコード例については、「クライアント領域以外のレンダリングの制御」を参照してください。

構文

HRESULT DwmGetWindowAttribute(
  [in]  HWND  hwnd,
  [in]  DWORD dwAttribute,
  [out] PVOID pvAttribute,
  [in]  DWORD cbAttribute
);

パラメーター

[in] hwnd

属性値の取得元となるウィンドウへのハンドル。

[in] dwAttribute

DWMWINDOWATTRIBUTE 列挙体の値として指定された、取得する値を記述するフラグ。 このパラメーターは、取得する属性を指定し、pvAttribute パラメーターは、属性値を取得するオブジェクトを指します。

[out] pvAttribute

この関数が正常に返されると、属性の現在の値を受け取る値へのポインター。 取得した値の型は、dwAttribute パラメーターの値によって異なります。 DWMWINDOWATTRIBUTE 列挙トピックは、各フラグの行で、pvAttribute パラメーターにポインターを渡す必要がある値の種類を示します。

[in] cbAttribute

pvAttribute パラメーターを介して受信される属性値のサイズ (バイト単位)。 取得した値の型、つまりバイト単位のサイズは、dwAttribute パラメーターの値によって異なります。

戻り値

型: HRESULT

関数が成功した場合は、S_OKを返します。 それ以外の場合は、HRESULTエラー コードを返します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dwmapi.h
ライブラリ Dwmapi.lib
DLL Dwmapi.dll

関連項目