IWICDdsEncoder::SetParameters-Methode (wincodec.h)

Legt DDS-spezifische Daten fest.

Syntax

HRESULT SetParameters(
  [out] WICDdsParameters *pParameters
);

Parameter

[out] pParameters

Typ: WICDdsParameters*

Zeigt auf die Struktur, in der die Informationen beschrieben werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Sie können diese Methode nicht aufrufen, nachdem Sie mit dem Schreiben von Framedaten begonnen haben, z. B. durch Aufrufen von IWICDdsEncoder::CreateNewFrame.

Das Festlegen von DDS-Parametern mithilfe dieser Methode stellt dem DDS-Encoder Informationen über die erwartete Anzahl von Frames und die Dimensionen und andere Parameter der einzelnen Frames bereit. Der DDS-Encoder schlägt fehl, wenn Sie keine Framedaten festlegen, die diesen Erwartungen entsprechen. Wenn Sie beispielsweise WICDdsParameters::Width and Height und MipLevels auf 6 festlegen, erwartet der DDS-Encoder 6 Frames mit den folgenden Dimensionen:

• 32 x 32 Pixel.
• 16 x 16 Pixel.
• 8x8 Pixel.
• 4x4 Pixel.
• 2x2 Pixel.
• 1x1 Pixel.

Anforderungen

Weitere Informationen

IWICDdsEncoder

WICDdsParameters