IWICDdsEncoder::SetParameters-Methode (wincodec.h)

  • Artikel

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll

Weitere Informationen

IWICDdsEncoder

WICDdsParameters