共用方式為

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

另請參閱

錯誤和成功碼

IOverlay 介面