Método CBasePropertyPage.OnConnect
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El OnConnect método proporciona un puntero IUnknown al objeto asociado a la página de propiedades.
Sintaxis
virtual HRESULT OnConnect(
IUnknown *pUnknown
);
Parámetros
-
pUnknown
-
Puntero a la interfaz IUnknown del objeto .
Valor devuelto
La implementación de clase base devuelve S_OK.
Observaciones
El método CBasePropertyPage::SetObjects llama al OnConnect método . Invalide este método para almacenar un puntero al objeto especificado por pUnknown. Puede almacenar el propio puntero pUnknown o consultar ese puntero para otras interfaces. Si almacena el puntero pUnknown , llame a AddRef antes de OnConnect volver.
En el método CBasePropertyPage::OnActivate , use el puntero almacenado (o punteros) para recuperar los valores iniciales de las propiedades del cuadro de diálogo. En el método CBasePropertyPage::OnApplyChanges , vuelva a aplicar los cambios al objeto . Libere todos los punteros del método CBasePropertyPage::OnDisconnect .
Ejemplos
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;
}
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|