IMixerPinConfig::GetColorKey メソッド (mpconfig.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは GetColorKey 、ビデオ ストリームで使用されているカラー キーを取得します。

構文

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

パラメーター

[out] pColorKey

キーの種類とパレット インデックスを含む COLORKEY 構造体へのポインター。

[out] pColor

現在の表示モードが 8 ビットの淡色化されている場合に返される COLORKEY の 8 ビット パレット インデックスを示す値へのポインター。 それ以外の場合は、現在の表示モードのピクセル形式でカラー キーを表す値です。

戻り値

HRESULT 値を返します。 次の値があります。

解説

プライマリ ストリームで値を取得すると、オーバーレイ サーフェイスで使用されている宛先カラー キーが取得されます。 セカンダリ ピンでこの値を取得すると、その特定のストリームで使用されているカラー キーが返されます。

このインターフェイスの現在の DirectShow 実装では、pColorKey パラメーターまたは pColor パラメーターの NULL を返すことができます。ただし、両方のパラメーターが NULL の場合、メソッドは失敗し、E_INVALIDARGを返します。

要件

関連項目

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

IMixerPinConfig インターフェイス

IMixerPinConfig::SetColorKey