IMediaDet::WriteBitmapBits
WriteBitmapBits メソッドは、指定されたメディア タイムのビデオ フレームを取得し、それをファイルに書き込む。ビデオ フレームは、常に 24 ビット RGB フォーマットである。
構文
HRESULT WriteBitmapBits(
double StreamTime,
long Width,
long Height,
BSTR Filename
);
パラメータ
StreamTime
ビデオ フレームを取得する時間。
Width
イメージの幅 (ピクセル単位)。
Height
イメージの高さ (ピクセル単位)。
Filename
ビットマップを保存するファイルのパス。ファイルが既に存在する場合、このメソッドはそのファイルに上書きする。
戻り値
成功した場合は、S_OK を返す。それ以外の場合は、エラーの原因を示す HRESULT 値を返す。次のいずれかのエラー コードを返す。
値 | 説明 |
E_NOINTERFACE | サンプル グラバ フィルタをグラフに追加できなかった。 |
E_FAIL | 失敗。 |
E_OUTOFMEMORY | メモリ不足。 |
E_UNEXPECTED | 予期せぬエラー。 |
STG_E_ACCESSDENIED | ファイルを上書きできない。 |
VFW_E_INVALIDMEDIATYPE | 無効なメディア タイプ。 |
注意
このメソッドを呼び出す前に、IMediaDet::put_Filename および IMediaDet::put_CurrentStream を呼び出してファイル名とストリームを設定すること。
このメソッドは、メディア ディテクタをビットマップ グラブ モードに設定する。このメソッドが呼び出された後は、メディア ディテクタの新しいインスタンスを作成しなければ、IMediaDet のさまざまなストリーム情報取得メソッドは機能しない。
要件
ヘッダー : Qedit.h をインクルードする。このヘッダー ファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。
ライブラリ : strmiids.lib を使用。
参照