サンプルグラバの使い方

[アーティクル]
04/22/2010

サンプルグラバフィルタは変換フィルタで、このフィルタを使ってストリームがフィルタグラフを通過するときにストリームからメディアサンプルを捕捉できる。

ただビデオファイルからビットマップを捕捉するだけの場合は、メディアディテクタ (MediaDet) オブジェクトを使った方が簡単である。詳細については、「ポスターフレームの捕捉」を参照すること。ただし、サンプルグラバの方が柔軟である。なぜなら、サンプルグラバはほぼあらゆるメディアタイプ (例外については、「ISampleGrabber::SetMediaType」を参照すること) を操作し、アプリケーションが制御できる範囲をより多く提供するからである。

フィルタグラフにサンプルグラバを追加する

最初に、サンプルグラバフィルタのインスタンスを作成し、そのインスタンスをフィルタグラフに追加する。

// サンプル グラバを作成する。
IBaseFilter *pGrabberF = NULL;
hr = CoCreateInstance(CLSID_SampleGrabber, NULL, CLSCTX_INPROC_SERVER,
    IID_IBaseFilter, (void**)&pGrabberF);
if (FAILED(hr))
{
    // エラーを返す。
}
hr = pGraph->AddFilter(pGrabberF, L"Sample Grabber");
if (FAILED(hr)
{
    // エラーを返す。
}

サンプルグラバに ISampleGrabber インターフェイスの有無を問い合わせる。

ISampleGrabber *pGrabber;
pGrabberF->QueryInterface(IID_ISampleGrabber, (void**)&pGrabber);

メディアタイプを設定する

サンプルグラバを最初に作成したときは、優先メディアタイプは設定されていない。これは、グラフ内のほぼすべてのフィルタに接続はできるが、受け取るデータタイプを制御できないとうことである。したがって、残りのグラフを作成する前に、ISampleGrabber::SetMediaType メソッドを呼び出して、サンプルグラバに対してメディアタイプを設定すること。

サンプルグラバは、接続した時に他のフィルタが提供するメディアタイプとこの設定されたメディアタイプとを比較する。調べるフィールドは、メジャータイプ、サブタイプ、フォーマットタイプだけである。これらのフィールドでは、値 GUID_NULL は "あらゆる値を受け付ける" という意味である。通常は、メジャータイプとサブタイプを設定する。たとえば、以下のコードでは非圧縮 24 ビット RGB ビデオを指定する。

AM_MEDIA_TYPE mt;
ZeroMemory(&mt, sizeof(AM_MEDIA_TYPE));
mt.majortype = MEDIATYPE_Video;
mt.subtype = MEDIASUBTYPE_RGB24;
hr = pGrabber->SetMediaType(&mt);

次の例では、ディスプレイのビット深度に基づきメディアタイプを設定する。

// 現在のビット深度を取得する。
HDC hdc = GetDC(NULL);
int iBitDepth = GetDeviceCaps(hdc, BITSPIXEL);
ReleaseDC(NULL, hdc);

// メディア タイプを設定する。
mt.majortype = MEDIATYPE_Video;
switch (iBitDepth)
{
case 8:
    mt.subtype = MEDIASUBTYPE_RGB8;
    break;
case 16:
    mt.subtype = MEDIASUBTYPE_RGB555;
    break;
case 24:
    mt.subtype = MEDIASUBTYPE_RGB24;
    break;
case 32:
    mt.subtype = MEDIASUBTYPE_RGB32;
    break;
default:
    return E_FAIL;
}
hr = pGrabber->SetMediaType(&mt);

フィルタグラフを作成する

これで、残りのフィルタグラフを作成できる。サンプルグラバは、指定されたメディアタイプを使って接続するだけなので、グラフを作成するときにフィルタグラフマネージャのインテリジェント接続メカニズムを利用できる。

たとえば、非圧縮ビデオを指定した場合、ソースフィルタをサンプルグラバに接続すると、フィルタグラフマネージャは自動的にファイルパーサーとデコーダを追加する。次の例では、ConnectFilters ヘルパー関数を使う。このヘルパー関数は「2 つのフィルタの接続」に記載されている。

IBaseFilter *pSrc;
hr = pGraph->AddSourceFilter(wszFileName, L"Source", &pSrc);
if (FAILED(hr))
{
    // エラー コードを返す。
}
hr = ConnectFilters(pGraph, pSrc, pGrabberF);

サンプルグラバは変換フィルタなので、出力ピンは別のフィルタに接続しておく必要がある。通常、使い終わったサンプルは破棄するだけである。そのような場合、サンプルグラバを Null レンダリングフィルタに接続する。Null レンダリングフィルタは、受け取ったデータを破棄する。

気を付けなければならないのは、サンプルグラバをビデオデコーダとビデオレンダラの間に配置すると、レンダリングのパフォーマンスが著しく低下するという点である。サンプルグラバはトランスフォームインプレイスフィルタである。これは、出力バッファが入力バッファと同じであるという意味である。ビデオのレンダリングの場合、出力バッファはグラフィックカード上にある可能性が高いが、グラフィックカードでの読み取り速度はメインメモリでの読み取り速度と比べてきわめて遅くなる。

グラフを実行する

サンプルグラバが機能するモードは 2 つある。

バッファリングモードでは、サンプルをダウンストリームへ出力する前に各サンプルのコピーを作成する。
コールバックモードでは、各サンプルに対してアプリケーション定義のコールバック関数を呼び出す。

ここでは、バッファリングモードについて説明する。コールバックモードを使うにあたっては、コールバック関数の使用は相当制限すべきであるという点に注意すること。制限しないと、パフォーマンスが大幅に低下するか、場合によってはデッドロックが起こる可能性がある。詳細については、ISampleGrabber::SetCallback」を参照すること。バッファリングモードをアクティブにするには、値 TRUE を設定して ISampleGrabber::SetBufferSamples メソッドを呼び出す。

オプションで、値 TRUE を設定して ISampleGrabber::SetOneShot メソッドを呼び出す。このメソッドを呼び出すと、サンプルグラバは最初のメディアサンプルを受け取った後でグラフを停止する。これはストリームから 1 つのフレームを捕捉したい場合に便利である。目的の時間にシークし、グラフを実行して、EC_COMPLETE イベントを待つ。フレームアキュレートのレベルは、ソースによって異なる。たとえば、MPEG ファイルのシークは通常はフレームアキュレートではない。

// ワンショット モードとバッファリングを設定する。
hr = pGrabber->SetOneShot(TRUE);
hr = pGrabber->SetBufferSamples(TRUE);

pControl->Run(); // グラフを実行する。
pEvent->WaitForCompletion(INFINITE, &evCode); // 完了するまで待機する。

できる限り早くグラフを実行するには、「グラフクロックの設定」で説明するようにグラフクロックをオフにする。

サンプルを捕捉する

バッファリングモードでは、サンプルグラバは各サンプルのコピーを保存する。ISampleGrabber::GetCurrentBuffer メソッドは、バッファを呼び出し元割り当て済みの配列にコピーする。必要な配列のサイズを判断するには、最初に配列アドレスに対して NULL ポインタを指定して GetCurrentBuffer を呼び出す。

// 必要なバッファ サイズを取得する。
long cbBuffer = 0;
hr = pGrabber->GetCurrentBuffer(&cbBuffer, NULL);

配列を割り当ててから、このメソッドを再度呼び出し、バッファをコピーする。

char *pBuffer = new char[cbBuffer];
if (!pBuffer) 
{
    // メモリ不足。エラー コードを返す。
}
hr = pGrabber->GetCurrentBuffer(&cbBuffer, (long*)pBuffer);

ISampleGrabber::GetConnectedMediaType メソッドは、バッファのフォーマットを返す。

AM_MEDIA_TYPE mt;
hr = pGrabber->GetConnectedMediaType(&mt);
if (FAILED(hr))
{
    // エラー コードを返す。
}
// フォーマット ブロックを調べる。
VIDEOINFOHEADER *pVih;
if ((mt.formattype == FORMAT_VideoInfo) && 
    (mt.cbFormat >= sizeof(VIDEOINFOHEADER)) &&
    (mt.pbFormat != NULL) ) 
{
    pVih = (VIDEOINFOHEADER*)mt.pbFormat;
}
else 
{
    // フォーマットが間違っている。フォーマット ブロックを解放し、エラーを返す。
    FreeMediaType(mt);
    return VFW_E_INVALIDMEDIATYPE; 
}
// メディア タイプを使って BITMAPINFOHEADRE 情報にアクセスできる。
// たとえば、次のコードは GDI を使ってビットマップを描く。
SetDIBitsToDevice(
    hdc, 0, 0, 
    pVih->bmiHeader.biWidth,
    pVih->bmiHeader.biHeight,
    0, 0, 
    0,
    pVih->bmiHeader.biHeight,
    pBuffer,
    (BITMAPINFO*)&pVih->bmiHeader,
    DIB_RGB_COLORS
);

// 完了したら、フォーマット ブロックを解放する。
FreeMediaType(mt);

サンプル グラバの使い方

その他のリソース

サンプルグラバの使い方