(wincodec.h) IWICDdsEncoder::SetParameters 方法

設定 DDS 特定數據。

語法

HRESULT SetParameters(
  [out] WICDdsParameters *pParameters
);

參數

[out] pParameters

類型: WICDdsParameters*

指向描述信息的結構。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

您無法在開始寫入框架數據之後呼叫這個方法,例如呼叫 IWICDdsEncoder::CreateNewFrame

使用此方法設定 DDS 參數會提供 DDS 編碼器,其中包含預期畫面數和每個畫面的維度和其他參數的相關信息。 如果您未設定符合這些期望的畫面數據,DDS 編碼器將會失敗。 例如,如果您將 WICDdsParameters::WidthHeight 設定為 32,並將 MipLevels 設定為 6,DDS 編碼器將預期有 6 個畫面格具有下列尺寸:

  • 32x32 像素。
  • 16x16 圖元。
  • 8x8 像素。
  • 4x4 圖元。
  • 2x2 圖元。
  • 1x1 像素。

規格需求

需求
最低支援的用戶端 Windows 8.1 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll

另請參閱

IWICDdsEncoder

WICDdsParameters