IWICBitmapFrameEncode：：SetPixelFormat 方法 (wincodec.h)
要求編碼器使用指定的像素格式。
語法
HRESULT SetPixelFormat(
[in, out] WICPixelFormatGUID *pPixelFormat
);
參數
[in, out] pPixelFormat
類型： WICPixelFormatGUID*
在輸入時，要求的像素格式 GUID。 輸出時，編碼器所支援的最接近圖元格式 GUID;這可能與要求的格式不同。 如需圖元格式 GUID 的清單，請參閱 原生圖元格式。
傳回值
類型： HRESULT
可能的傳回值包括下列專案。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
未呼叫 IWICBitmapFrameEncode：：Initialize 方法。 |
備註
編碼器可能不支援要求的像素格式。 如果沒有， SetPixelFormat 會在 pPixelFormat 指向的記憶體區塊中傳回最接近的相符專案。 如果傳回的像素格式不符合要求的格式，您必須使用 IWICFormatConverter 對象來轉換圖元數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincodec.h |
| 程式庫 | Windowscodecs.lib |
| Dll | Windowscodecs.dll |