CPosPassThru クラス

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

クラスは CPosPassThru 、変換フィルターの seek コマンドを次のフィルターに上流に渡すことによって処理します。

アプリケーションがフィルター グラフをシークすると、フィルター グラフ マネージャーによって seek コマンドがレンダラー フィルターに渡されます。 コマンドは、コマンドを実行できるフィルター (存在する場合) に達するまで、各フィルターの出力ピンを介してアップストリームに渡されます。 詳細については、「 Seeking」を参照してください。 クラスは CPosPassThru 、次の図に示すように、すべての seek コマンドをアップストリーム フィルターの出力ピンに渡します。

このクラスは基底クラス ライブラリで提供されますが、DirectShow は Quartz.dll でも同じクラスを提供します。 Quartz.dll バージョンを使用すると、クラスが DLL から実行時に読み込まれるため、フィルター内のコード サイズを多少小さくできます。 そのバージョンを使用するには、 CreatePosPassThru 関数を呼び出します。

次のコードに示すように、出力ピンの NonDelegatingQueryInterface メソッドで、要求されたインターフェイスが IMediaSeeking または IMediaPosition である場合は常に CPosPassThru オブジェクトにデリゲートします。

// The following member variables are assumed:
IPin *m_pInput;    // Pointer to the input pin on your filter.
IUnknown *m_pPos;  // Pointer to the CPosPassThru object.

STDMETHODIMP CMyPin::NonDelegatingQueryInterface(REFIID riid, void **ppv)
{
    HRESULT hr
    if (riid == IID_IMediaPosition || riid == IID_IMediaSeeking) 
    {
        if (m_pPos == NULL) 
        {
            // We have not created the CPosPassThru object yet. Do so now.
            hr = CreatePosPassThru(GetOwner(), FALSE, m_pInput, &m_pPos);
            if (FAILED(hr)) return hr;
        }
        return m_pPos->QueryInterface(riid, ppv);
    } 
    else
    {
         // Other interfaces (not shown).
    }
}

~CMyPin::CMyPin() 
{
    // Release the CPosPassThruObject.
    if (m_pPos != NULL) m_pPos->Release();
}

記載されている場合を除き、このクラスのすべての IMediaPosition メソッドと IMediaSeeking メソッドは、接続されたピンの対応するメソッドを呼び出し、結果を返します。

要件