CPosPassThru 類別

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

類別 CPosPassThru 會處理轉換篩選準則的搜尋命令，方法是將其傳遞至下一個篩選準則。

當應用程式搜尋篩選圖形時，Filter Graph 管理員會提供搜尋命令給轉譯器篩選。 命令會透過每個篩選的輸出針腳傳遞至上游，直到到達可執行命令的篩選， (如果有任何) 。 如需詳細資訊，請參閱 搜尋。 類別 CPosPassThru 會將所有搜尋命令傳遞至上游篩選上的輸出針腳，如下圖所示。

雖然此類別是在基類庫中提供，但 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 方法都會在連接的針腳上呼叫對應的方法，並傳回結果。

規格需求