Метод CBasePropertyPage.OnConnect

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод OnConnect предоставляет указатель IUnknown на объект, связанный со страницей свойств.

Синтаксис

virtual HRESULT OnConnect(
   IUnknown *pUnknown
);

Параметры

pUnknown: Указатель на интерфейс IUnknown объекта .

Возвращаемое значение

Реализация базового класса возвращает S_OK.

Метод CBasePropertyPage::SetObjects вызывает OnConnect метод . Переопределите этот метод, чтобы сохранить указатель на объект, указанный параметром pUnknown. Вы можете сохранить сам указатель pUnknown или запросить этот указатель для других интерфейсов. Если вы сохраняете указатель pUnknown , вызовите Метод AddRef перед OnConnect возвратом.

В методе CBasePropertyPage::OnActivate используйте сохраненный указатель (или указатели) для получения начальных значений для свойств диалогового окна. В методе CBasePropertyPage::OnApplyChanges примените все изменения к объекту . Отпустите все указатели в методе CBasePropertyPage::OnDisconnect .

Примеры

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

Требования

Требование	Значение
Заголовок	Cprop.h (включая Streams.h)
Библиотека	Strmbase.lib (розничные сборки); Strmbasd.lib (отладочные сборки)

См. также раздел

Класс CBasePropertyPage

Поделиться через