共用方式為


CImagePalette.MakeIdentityPalette 方法

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]

方法 MakeIdentityPalette 會嘗試建立「識別選擇區」,定義為直接對應至顯示裝置中所選取調色盤的調色盤。

語法

HRESULT MakeIdentityPalette(
   PALETTEENTRY *pEntry,
   INT          iColours,
   LPSTR        szDevice
);

參數

pEntry

調色盤專案的陣列指標。

iColours

pEntry中的調色盤專案數目。

szDevice

包含顯示裝置名稱的字串指標,如 GDI EnumDisplayDevices 函式所傳回。 若要使用主要顯示裝置,請將此參數設定為 Null

傳回值

如果成功,則傳回S_OK,如果失敗,則傳回S_FALSE。

備註

此方法會將系統選擇區中的保留專案與 pEntry 陣列中的對應專案進行比較。 如果完全相符,方法會在 pEntry中其餘 (非保留) 調色盤專案中設定PC_NOCOLLAPSE旗標。 此旗標可防止 GDI 嘗試將邏輯調色盤專案對應至系統調色盤專案。

CImagePalette::MakePalette方法會呼叫這個方法。

規格需求

需求
標頭
Winutil.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CImagePalette 類別