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

Метод 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 в объекте активации или
  • Вызовите метод завершения работы, зависящий от объекта. Этот метод будет зависеть от типа объекта . Помимо прочих, возможны следующие варианты:
Метод IMFActivate::ShutdownObject является универсальным для всех типов объектов. Если для объекта не требуется метод завершения работы, ShutdownObject завершается успешно и не оказывает никакого влияния. Если вы не знаете конкретный метод завершения работы для объекта (или не знаете тип объекта), вызовите IMFActivate::ShutdownObject.

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

Требования

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

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

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

IMFActivate