共用方式為

CBasePropertyPage.OnConnect 方法

  • 發行項

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

方法 OnConnect 會提供與屬性頁相關聯之物件的 IUnknown 指標。

語法

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

參數

pUnknown

物件的 IUnknown 介面指標。

傳回值

基類實作會傳回S_OK。

備註

CBasePropertyPage：：SetObjects方法會呼叫 OnConnect 方法。 覆寫這個方法，以儲存 pUnknown所指定物件的指標。 您可以儲存 pUnknown 指標本身，或查詢其他介面的指標。 如果您儲存 pUnknown 指標，請先呼叫 AddRef 再 OnConnect 傳回。

在 CBasePropertyPage：：OnActivate 方法中，使用預存指標 (或指標) 來擷取對話方塊屬性的初始值。 在 CBasePropertyPage：：OnApplyChanges 方法中，將任何變更套用回物件。 釋放 CBasePropertyPage：：OnDisconnect 方法中的所有指標。

範例

HRESULT CMyProp::OnConnect(IUnknown *pUnk)
{
    ASSERT(m_pOwningFilter == NULL);
    HRESULT hr;
    // Query pUnk for the filter's custom interface.
    hr = pUnk->QueryInterface(IID_ISomeCustomInterface,
             reinterpret_cast<void**>(&m_pOwningFilter));
    return hr;
}

規格需求

需求 值
標頭
Cprop.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBasePropertyPage 類別