IPin::ConnectionMediaType

  • [アーティクル]

ConnectionMediaType メソッドは、現在ピン接続がある場合はそのピン接続のメディア タイプを取得する。

構文

  HRESULT ConnectionMediaType(
  AM_MEDIA_TYPE *pmt
);

パラメータ

pmt

[out] メディア タイプを受け取る AM_MEDIA_TYPE 構造体へのポインタ。

戻り値

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

値 説明
S_OK 成功。
E_POINTER NULL ポインタ引数。
VFW_E_NOT_CONNECTED ピンが接続されていない。

注意

ピンが接続されている場合、このメソッドはメディア タイプを pmt によって指定される AM_MEDIA_TYPE 構造体にコピーする。呼び出し元はメディア タイプのフォーマット ブロックを解放しなければならない。Microsoft® Win32® CoTaskMemFree 関数か、FreeMediaType ヘルパー関数を使える。

ピンが接続されないと、このメソッドは pmt が指定するメディア タイプをクリアし、エラー コードを返す。

参照