Metode CBasePropertyPage.OnConnect

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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 OnConnect menyediakan penunjuk IUnknown ke objek yang terkait dengan halaman properti.

Sintaks

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

Parameter

pUnknown

Arahkan ke antarmuka IUnknown objek.

Mengembalikan nilai

Implementasi kelas dasar mengembalikan S_OK.

Keterangan

Metode CBasePropertyPage::SetObjects memanggil OnConnect metode . Ambil alih metode ini untuk menyimpan penunjuk ke objek yang ditentukan oleh pUnknown. Anda dapat menyimpan pointer pUnknown itu sendiri, atau mengkueri pointer tersebut untuk antarmuka lain. Jika Anda menyimpan pointer pUnknown , hubungi AddRef sebelum OnConnect kembali.

Dalam metode CBasePropertyPage::OnActivate , gunakan penunjuk tersimpan (atau penunjuk) untuk mengambil nilai awal untuk properti dialog. Dalam metode CBasePropertyPage::OnApplyChanges, terapkan perubahan apa pun kembali ke objek. Lepaskan semua pointer di metode CBasePropertyPage::OnDisconnect .

Contoh

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;
}

Persyaratan

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

Lihat juga

Kelas CBasePropertyPage