CBasePin::EnumMediaTypes
EnumMediaTypes メソッドは、ピンの優先メディア タイプを列挙する。このメソッドは IPin::EnumMediaTypes メソッドを実装する。
構文
HRESULT EnumMediaTypes(
IEnumMediaTypes **ppEnum
);
パラメータ
ppEnum
IEnumMediaTypes インターフェイスへのポインタを受け取る変数のアドレス。
戻り値
HRESULT 値を返す。可能な値は次の一覧のとおりである。
値 | 説明 |
S_OK | 成功。 |
E_OUTOFMEMORY | メモリ不足。 |
E_POINTER | NULL ポインタ引数。 |
注意
入力ピンは優先タイプの列挙を要求されない。出力ピンは少なくとも 1 つの優先タイプを列挙しなければならない。そうしないと、両方のピンに優先タイプがなくなり、接続が不可能になる。
IEnumMediaTypes インターフェイスは標準 COM 列挙子のように動作する。詳細については、「フィルタ グラフ内のオブジェクトの列挙」を参照すること。メソッドが成功すると、IEnumMediaTypes インターフェイスに未処理の参照カウントが残る。使用後は必ず解放する必要がある。
CEnumMediaTypes 基底クラスは IEnumMediaTypes を実装する。この基底クラスはピンの CBasePin::GetMediaType メソッドを呼び出して、メディア タイプを列挙する。
参照