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

Метод IMFMediaSession::GetFullTopology (mfidl.h)

  • Статья

Возвращает топологию из сеанса мультимедиа.

Этот метод может получить текущую топологию или топологию в очереди.

Синтаксис

HRESULT GetFullTopology(
  [in]  DWORD       dwGetFullTopologyFlags,
  [in]  TOPOID      TopoId,
  [out] IMFTopology **ppFullTopology
);

Параметры

[in] dwGetFullTopologyFlags

Побитовое ИЛИ с нулевым или более флагами из перечисления MFSESSION_GETFULLTOPOLOGY_FLAGS .

[in] TopoId

Идентификатор топологии. Этот параметр игнорируется, если параметр dwGetFullTopologyFlags содержит флаг MFSESSION_GETFULLTOPOLOGY_CURRENT . Чтобы получить идентификатор топологии, вызовите IMFTopology::GetTopologyID.

[out] ppFullTopology

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

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_SHUTDOWN
 Сеанс мультимедиа завершен.

Комментарии

Если флаг MFSESSION_GETFULLTOPOLOGY_CURRENT указан в параметре dwGetFullTopologyFlags , метод возвращает топологию для текущей презентации. В противном случае метод выполняет поиск во всех топологиях в очереди, которые соответствуют идентификатору, указанному в параметре TopoId .

Этот метод можно использовать для получения топологии для текущей презентации или любых ожидающих презентаций. Его нельзя использовать для получения топологии, которая уже завершилась.

Топология, возвращаемая в ppFullTopo , является полной, а не частичной топологией.

Требования

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

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

IMFMediaSession

TOPOID