IMediaSample::GetMediaType
GetMediaType メソッドは、メディア タイプが前のサンプルと異なる場合、メディア タイプを取得する。
構文
HRESULT GetMediaType(
AM_MEDIA_TYPE **ppMediaType
);
パラメータ
ppMediaType
AM_MEDIA_TYPE 構造体へのポインタを受け取る変数のアドレス。メディア タイプが以前のサンプルから変更になっていない場合、*ppMediaType には NULL が設定される。
戻り値
HRESULT 値を返す。可能な値は次の一覧のとおりである。
値 | 説明 |
S_FALSE | メディア タイプは以前のサンプルから変更されていない。 |
S_OK | 成功。 |
E_OUTOFMEMORY | メモリ不足。 |
注意
このメソッドによってフィルタはパレット変更のような限定したメディア タイプの変更を行うことができる。メディア タイプを大幅に変更する場合、ピンは再接続して、メディア タイプを再ネゴシエートする必要がある。
メソッドが S_OK を返したら、呼び出し元はフォーマット ブロックを含め、メディア タイプのメモリを必ず解放すること。DirectShow 基底クラス ライブラリの関数 DeleteMediaType を使える。
参照