Share via

IOverlay::SetPalette メソッド (strmif.h)

  • [アーティクル]

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 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 を含む)
Library Strmiids.lib

関連項目

エラーコードと成功コード

IOverlay インターフェイス