IWICDdsEncoder::SetParameters method (wincodec.h)

Sets DDS-specific data.

Syntax

HRESULT SetParameters(
  [out] WICDdsParameters *pParameters
);

Parameters

[out] pParameters

Type: WICDdsParameters*

Points to the structure where the information is described.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

You cannot call this method after you have started to write frame data, for example by calling IWICDdsEncoder::CreateNewFrame.

Setting DDS parameters using this method provides the DDS encoder with information about the expected number of frames and the dimensions and other parameters of each frame. The DDS encoder will fail if you do not set frame data that matches these expectations. For example, if you set WICDdsParameters::Width and Height to 32, and MipLevels to 6, the DDS encoder will expect 6 frames with the following dimensions:

  • 32x32 pixels.
  • 16x16 pixels.
  • 8x8 pixels.
  • 4x4 pixels.
  • 2x2 pixels.
  • 1x1 pixels.

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 R2 [desktop apps | UWP apps]
Target Platform Windows
Header wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll

See also

IWICDdsEncoder

WICDdsParameters