次の方法で共有


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 を使用。

参照