IWICDdsEncoder::SetParameters メソッド (wincodec.h)

  • [アーティクル]

DDS 固有のデータを設定します。

構文

HRESULT SetParameters(
  [out] WICDdsParameters *pParameters
);

パラメーター

[out] pParameters

種類: WICDdsParameters*

情報が記述されている構造を指します。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

フレーム データの書き込みを開始した後で、たとえば IWICDdsEncoder::CreateNewFrame を呼び出すと、このメソッドを呼び出すことはできません。

このメソッドを使用して DDS パラメーターを設定すると、DDS エンコーダーに、予想されるフレーム数と各フレームの寸法やその他のパラメーターに関する情報が提供されます。 これらの期待値に一致するフレーム データを設定しないと、DDS エンコーダーは失敗します。 たとえば、 WICDdsParameters::Width と Height を 32 に設定し、 MipLevels を 6 に設定した場合、DDS エンコーダーでは次のディメンションを持つ 6 つのフレームが想定されます。

  • サイズは 32x32 ピクセルです。
  • 16 x 16 ピクセル。
  • 8x8 ピクセル。
  • 4 x 4 ピクセル。
  • 2x2 ピクセル。
  • 1x1 ピクセル。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincodec.h
Library Windowscodecs.lib
[DLL] Windowscodecs.dll

こちらもご覧ください

IWICDdsEncoder

WICDdsParameters