次の方法で共有


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

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

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

構文

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

パラメーター

[out] pColorKey

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

[out] pColor

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

戻り値

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

リターン コード 説明
E_INVALIDARG
引数が無効です。両方のパラメーターが NULL です
E_FAIL
GetColorKey カラー キーが不明なため、失敗しました。
NOERROR
成功しました。

解説

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

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

メモpColor パラメーターによって返される DWORD 値は、使用されている実際の色です。 したがって、ディスプレイのビット深度が 8、16、24、32 の場合、 DWORD の最後の 8、16、24、または 32 ビットは、カラー キーの実際の値を指定します。
 

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mpconfig.h
Library Strmiids.lib

関連項目

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

IMixerPinConfig インターフェイス

IMixerPinConfig::SetColorKey