Metode CBasePropertyPage.SetObjects

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode ini SetObjects menyediakan pointer IUnknown untuk objek yang terkait dengan halaman properti. Metode ini mengimplementasikan metode IPropertyPage::SetObjects .

Sintaks

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

Parameter

cObjects: Menentukan jumlah pointer IUnknown dalam array yang ditentukan oleh ppUnk.
ppUnk: Menentukan array pointer IUnknown .

Nilai kembali

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Argumen penunjuk NULL.
E_UNEXPECTED	Kegagalan tak terduga.

Keterangan

Meskipun ppUnk menentukan array pointer IUnknown , kelas CBasePropertyPage dirancang hanya untuk mendukung satu objek terkait. Jika cObjects lebih besar dari 1, metode mengembalikan E_UNEXPECTED.

Jika cObjects sama dengan 1, metode ini memanggil metode CBasePropertyPage::OnConnect . Jika cObjects sama dengan 0, metode ini memanggil metode CBasePropertyPage::OnDisconnect . Kelas turunan harus mengambil alih kedua metode tersebut; untuk detailnya, lihat keterangan untuk metode tersebut.

Persyaratan

Persyaratan	Nilai
Header	Cprop.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Kelas CBasePropertyPage

Share via