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

Статья
08/24/2023

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

Синтаксис

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

Параметры

[in] riid

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

[out] ppv

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

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

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

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

Вызовите IMFActivate::ShutdownObject в объекте активации или
Вызовите метод завершения работы, зависящий от объекта. Этот метод будет зависеть от типа объекта . Помимо прочих, возможны следующие варианты:
- Источники средств массовой информации: Позвоните IMFMediaSource::Shutdown.
- Медиа-приемники: Позвоните IMFMediaSink::Shutdown.
- Любой объект, поддерживающий интерфейс IMFShutdown : Вызов IMFShutdown::Shutdown.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	mfobjects.h
Библиотека	Mfuuid.lib

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

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

IMFActivate