CBasePropertyPage.SetObjects 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
方法 SetObjects
會為與屬性頁相關聯的物件提供 IUnknown 指標。 這個方法會實作 IPropertyPage::SetObjects 方法。
語法
HRESULT SetObjects(
ULONG cObjects,
LPUNKNOWN *ppUnk
);
參數
-
cObjects
-
指定ppUnk所指定陣列中的IUnknown指標數目。
-
ppUnk
-
指定 IUnknown 指標的陣列。
傳回值
傳回 HRESULT 值。 可能的值如下。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
Null 指標引數。 |
|
發生非預期的失敗。 |
備註
雖然 ppUnk 指定 IUnknown 指標的陣列, 但 CBasePropertyPage 類別的設計只是為了支援一個相關聯的物件。 如果 cObjects 大於 1,此方法會傳回E_UNEXPECTED。
如果 cObjects 等於 1,這個方法會呼叫 CBasePropertyPage::OnConnect 方法。 如果 cObjects 等於 0,這個方法會呼叫 CBasePropertyPage::OnDisconnect 方法。 衍生類別應該覆寫這兩種方法;如需詳細資訊,請參閱這些方法的備註。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|