Metodo CBasePropertyPage.OnConnect
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il OnConnect metodo fornisce un puntatore IUnknown all'oggetto associato alla pagina delle proprietà.
Sintassi
virtual HRESULT OnConnect(
IUnknown *pUnknown
);
Parametri
-
pUnknown
-
Puntatore all'interfaccia IUnknown dell'oggetto .
Valore restituito
L'implementazione della classe base restituisce S_OK.
Commenti
Il metodo CBasePropertyPage::SetObjects chiama il OnConnect metodo . Eseguire l'override di questo metodo per archiviare un puntatore all'oggetto specificato da pUnknown. È possibile archiviare il puntatore pUnknown stesso oppure eseguire una query sul puntatore per altre interfacce. Se si archivia il puntatore pUnknown , chiamare AddRef prima OnConnect di restituire.
Nel metodo CBasePropertyPage::OnActivate utilizzare il puntatore archiviato (o puntatori) per recuperare i valori iniziali per le proprietà del dialogo. Nel metodo CBasePropertyPage::OnApplyChanges applicare eventuali modifiche all'oggetto. Rilasciare tutti i puntatori nel metodo CBasePropertyPage::OnDisconnect .
Esempio
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;
}
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|