Méthode CBasePropertyPage.OnConnect
[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 |
|
| Bibliothèque |
|