IMediaSample2::GetProperties
GetProperties メソッドは、メディア サンプルのプロパティを取得する。
構文
HRESULT GetProperties(
DWORD cbProperties,
BYTE *pbProperties
);
パラメータ
cbProperties
[in] 取得するプロパティ データの長さ (バイト単位)。
pbProperties
[out] cbProperties サイズのバッファへのポインタ。
戻り値
HRESULT 値を返す。可能な値は次のとおりである。
値 | 説明 |
S_OK | 成功。 |
E_POINTER | NULL ポインタ引数。 |
注意
取得したデータは AM_SAMPLE2_PROPERTIES 構造体のフォーマットに従う。cbProperties を AM_SAMPLE2_PROPERTIES 構造体のサイズより小さい値に設定すれば、サンプル プロパティのサブセットを取得できる。
効率のため、AM_SAMPLE2_PROPERTIES に返される pMediaType メンバはメディア サンプルに格納されているデータへのポインタであり、そのデータのコピーではない。サンプルが他のフィルタに渡された後、あるいは入力ピンの IMemInputPin::Receive メソッドが完了した後では、そのポインタは無効となる可能性がある。またメディア タイプを解放あるいは削除してはならない。
参照