IMediaDet::GetSampleGrabber
GetSampleGrabber メソッドは、ISampleGrabber インターフェイスへのポインタを取得する。このインターフェイスにより、アプリケーションでメディア ストリームから個々のサンプルを取得できる。
構文
HRESULT GetSampleGrabber(
ISampleGrabber **ppVal
);
パラメータ
ppVal
[out] ISampleGrabber インターフェイスを受け取るポインタのアドレス。
戻り値
次のいずれかの HRESULT 値を返す。
値 | 説明 |
S_OK | 成功。 |
E_NOINTERFACE | メディア ディテクタがビットマップ グラブ モードであるため、インターフェイスを取得できない。 |
E_POINTER | NULL ポインタ引数。 |
注意
このメソッドを呼び出す前に、IMediaDet::EnterBitmapGrabMode を呼び出すこと。ISampleGrabber インターフェイスによって、ストリームから個々のメディア サンプルを取得できる。ビデオ フレーム用のビットマップが必要なだけの場合は、代わりに IMediaDet::GetBitmapBits メソッドを呼び出す。ISampleGrabber インターフェイスの方が柔軟性はあるが、アプリケーション側で必要な処理も多くなる。
このメソッドが成功した場合、返される ISampleGrabber インターフェイスに未処理の参照カウントが残る。使用後、インターフェイスを必ず解放すること。
要件
ヘッダー : Qedit.h をインクルードする。このヘッダー ファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。
ライブラリ : strmiids.lib を使用。
参照