Méthode CBasePropertyPage.OnConnect

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La OnConnect méthode fournit un pointeur IUnknown vers l’objet associé à la page de propriétés.

Syntaxe

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

Paramètres

pUnknown

Pointeur vers l’interface IUnknown de l’objet .

Valeur renvoyée

L’implémentation de classe de base retourne S_OK.

Notes

La méthode CBasePropertyPage::SetObjects appelle la OnConnect méthode . Remplacez cette méthode pour stocker un pointeur vers l’objet spécifié par pUnknown. Vous pouvez stocker le pointeur pUnknown lui-même ou interroger ce pointeur pour d’autres interfaces. Si vous stockez le pointeur pUnknown , appelez AddRef avant OnConnect de retourner.

Dans la méthode CBasePropertyPage::OnActivate , utilisez le pointeur (ou les pointeurs) stockés pour récupérer les valeurs initiales des propriétés de la boîte de dialogue. Dans la méthode CBasePropertyPage::OnApplyChanges , appliquez toutes les modifications apportées à l’objet . Libérez tous les pointeurs dans la méthode CBasePropertyPage::OnDisconnect .

Exemples

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

Configuration requise

Condition requise Valeur
En-tête
Cprop.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CBasePropertyPage, classe