共用方式為


CBasePropertyPage.SetObjects 方法

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

方法 SetObjects 會為與屬性頁相關聯的物件提供 IUnknown 指標。 這個方法會實作 IPropertyPage::SetObjects 方法。

語法

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

參數

cObjects

指定ppUnk所指定陣列中的IUnknown指標數目。

ppUnk

指定 IUnknown 指標的陣列。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 描述
S_OK
成功。
E_POINTER
Null 指標引數。
E_UNEXPECTED
發生非預期的失敗。

備註

雖然 ppUnk 指定 IUnknown 指標的陣列, 但 CBasePropertyPage 類別的設計只是為了支援一個相關聯的物件。 如果 cObjects 大於 1,此方法會傳回E_UNEXPECTED。

如果 cObjects 等於 1,這個方法會呼叫 CBasePropertyPage::OnConnect 方法。 如果 cObjects 等於 0,這個方法會呼叫 CBasePropertyPage::OnDisconnect 方法。 衍生類別應該覆寫這兩種方法;如需詳細資訊,請參閱這些方法的備註。

規格需求

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

另請參閱

CBasePropertyPage 類別