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

Confira também

Classe CBasePropertyPage