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 |