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 値を返します。 次の値があります。
リターン コード | 説明 |
---|---|
|
引数が無効です。両方のパラメーターが NULL です。 |
|
GetColorKey カラー キーが不明なため、失敗しました。
|
|
成功しました。 |
解説
プライマリ ストリームで値を取得すると、オーバーレイ サーフェイスで使用されている宛先カラー キーが取得されます。 セカンダリ ピンでこの値を取得すると、その特定のストリームで使用されているカラー キーが返されます。
このインターフェイスの現在の DirectShow 実装では、pColorKey パラメーターまたは pColor パラメーターの NULL を返すことができます。ただし、両方のパラメーターが NULL の場合、メソッドは失敗し、E_INVALIDARGを返します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mpconfig.h |
Library | Strmiids.lib |