Метод IMFMediaTypeHandler::SetCurrentMediaType (mfidl.h)

  • Статья

Задает тип носителя объекта.

Синтаксис

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Параметры

[in] pMediaType

Указатель на интерфейс IMFMediaType нового типа носителя.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_INVALIDREQUEST
 Недопустимый запрос.

Комментарии

Для источников мультимедиа установка типа носителя означает, что источник будет создавать данные, соответствующие этому типу мультимедиа. Для приемников мультимедиа задание типа носителя означает, что приемник может получать данные, соответствующие этому типу мультимедиа.

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

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK формата 11 для Windows Media:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления для Windows XP Media Center Edition за октябрь 2006 г.).

Требования

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

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

IMFMediaTypeHandler