Share via

IWICBitmapFrameEncode：：SetPixelFormat 方法 (wincodec.h)

  • 發行項

要求編碼器使用指定的像素格式。

語法

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

參數

[in, out] pPixelFormat

類型： WICPixelFormatGUID*

在輸入時，要求的像素格式 GUID。 輸出時，編碼器所支援的最接近圖元格式 GUID;這可能與要求的格式不同。 如需圖元格式 GUID 的清單，請參閱 原生圖元格式。

傳回值

類型： HRESULT

可能的傳回值包括下列專案。

傳回碼 描述
S_OK
 成功。
WINCODEC_ERR_WRONGSTATE
 未呼叫 IWICBitmapFrameEncode：：Initialize 方法。

備註

編碼器可能不支援要求的像素格式。 如果沒有， SetPixelFormat 會在 pPixelFormat 指向的記憶體區塊中傳回最接近的相符專案。 如果傳回的像素格式不符合要求的格式，您必須使用 IWICFormatConverter 對象來轉換圖元數據。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib
Dll Windowscodecs.dll

另請參閱

IWICBitmapFrameEncode

原生圖元格式