iOverlay：：SetPalette 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
方法會 SetPalette 設定調色盤。
語法
HRESULT SetPalette(
[in] DWORD dwColors,
[in] PALETTEENTRY *pPalette
);
參數
[in] dwColors
存在的色彩數目。
[in] pPalette
要用於調色盤之色彩的指標。
傳回值
如果成功，則傳回S_OK。 如果方法失敗，它會傳回 HRESULT 錯誤碼。
備註
這個方法會設定視窗的邏輯調色盤。 視窗不保證一律會要求實際系統裝置調色盤中的色彩。 當視窗是前景使用中視窗時，Microsoft® Windows® 作業系統只會保證這些色彩。 呼叫 IOverlay：：GetPalette即可取得目前的裝置選擇區。
如果裝置沒有調色盤，則會傳回VFW_E_NO_DISPLAY_PALETTE。
重迭混音器篩選會傳回E_NOTIMPL。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |