Share via

CBasePin::AgreeMediaType

  • [アーティクル]

AgreeMediaType メソッドは、ピン接続をするメディア タイプを検索する。

構文

  virtual HRESULT AgreeMediaType(
    IPin *pReceivePin,
    const CMediaType *pmt
);

パラメータ

pReceivePin

受信ピンの IPin インターフェイスへのポインタ。

pmt

メディア タイプを指定する CMediaType オブジェクトへのポインタ、または NULL。

戻り値

HRESULT 値を返す。可能な値は次の一覧のとおりである。

値 説明
S_OK 成功。
VFW_E_NO_ACCEPTABLE_TYPES 受け入れ可能なメディア タイプは見つからなかった。

注意

pmt パラメータが NULL 以外で、メディア タイプを完全に指定している場合、このメソッドはそのメディア タイプを使って接続を試みる。これが失敗すると、このメソッドはエラーを返す。

pmt パラメータが NULL またはパーシャル メディア タイプの場合、このメソッドは次の順序でメディア タイプを試す。

  1. 受信ピンの優先メディア タイプ。
  2. このピンの優先メディア タイプ。

優先メディア タイプは CBasePin::EnumMediaTypes メソッドで列挙され、列挙された結果は CBasePin::TryMediaTypes メソッドに渡される。

参照