Метод IMFActivate::ActivateObject (mfobjects.h)

Создает объект, связанный с этим объектом активации.

Синтаксис

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

Параметры

[in] riid

Идентификатор интерфейса (IID) запрошенного интерфейса.

[out] ppv

Получает указатель на запрошенный интерфейс. Вызывающий объект должен освободить интерфейс.

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

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Перед выпуском необходимо закрыть некоторые объекты Microsoft Media Foundation. Если это так, вызывающий объект отвечает за завершение работы объекта, возвращаемого в ppv. Чтобы завершить работу объекта, выполните одно из следующих действий.

• Вызов IMFActivate::ShutdownObject в объекте активации или
• Вызовите метод завершения работы конкретного объекта. Этот метод будет зависеть от типа объекта. К ним относятся следующие возможности:
  • Источники средств массовой информации: вызов МВФMediaSource::Завершение работы.
  • Приемники мультимедиа: вызов МВФMediaSink::Завершение работы.
  • Любой объект, поддерживающий интерфейс МВФShutdown: вызов МВФShutdown::Shutdown.

Метод IMFActivate::ShutdownObject является универсальным для всех типов объектов. Если объект не требует метода завершения работы, ShutdownObject успешно выполнено и не имеет эффекта. Если вы не знаете конкретный метод завершения работы объекта (или не знаете тип объекта), вызовите IMFActivate::ShutdownObject.

После первого вызова ActivateObjectпоследующие вызовы возвращают указатель на тот же экземпляр, пока клиент не вызывает ShutdownObject или IMFActivate::D etachObject.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2008 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
заголовка	mfobjects.h
библиотеки	Mfuuid.lib

См. также

объекты активации

МВФActivate