Método CBasePropertyPage.OnConnect
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O OnConnect método fornece um ponteiro IUnknown para o objeto associado à página de propriedades.
Sintaxe
virtual HRESULT OnConnect(
IUnknown *pUnknown
);
Parâmetros
-
pUnknown
-
Ponteiro para a interface IUnknown do objeto .
Retornar valor
A implementação da classe base retorna S_OK.
Comentários
O método CBasePropertyPage::SetObjects chama o OnConnect método . Substitua esse método para armazenar um ponteiro para o objeto especificado por pUnknown. Você pode armazenar o ponteiro pUnknown em si ou consultar esse ponteiro para outras interfaces. Se você armazenar o ponteiro pUnknown , chame AddRef antes OnConnect de retornar.
No método CBasePropertyPage::OnActivate , use o ponteiro armazenado (ou ponteiros) para recuperar valores iniciais para as propriedades da caixa de diálogo. No método CBasePropertyPage::OnApplyChanges , aplique as alterações de volta ao objeto . Solte todos os ponteiros no método CBasePropertyPage::OnDisconnect .
Exemplos
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 | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|