Метод IMFPMediaPlayer::SetMediaItem (mfplay.h)

Важно Устаревшие. Этот API может быть удален из будущих выпусков Windows. Приложения должны использовать сеанс мультимедиа для воспроизведения.

 

Помещает элемент мультимедиа в очередь для воспроизведения.

Синтаксис

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

Параметры

[in] pIMFPMediaItem

Указатель на интерфейс IMFPMediaItem элемента мультимедиа.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Недопустимый аргумент.
MF_E_DRM_UNSUPPORTED	Элемент мультимедиа содержит защищенное содержимое. В настоящее время MFPlay не поддерживает защищенное содержимое.
MF_E_NO_AUDIO_PLAYBACK_DEVICE	Устройство воспроизведения звука не найдено. Эта ошибка может возникнуть, если источник мультимедиа содержит звук, но в системе нет доступных устройств воспроизведения звука.
MF_E_SHUTDOWN	Был вызван метод Shutdown объекта .

Комментарии

Этот метод выполняется асинхронно. После завершения операции вызывается метод обратного вызова ПРИЛОЖЕНИЯ IMFPMediaPlayerCallback::OnMediaPlayerEvent . Тип события — MFP_EVENT_TYPE_MEDIAITEM_SET.

Чтобы создать элемент мультимедиа, вызовите IMFPMediaPlayer::CreateMediaItemFromObject или IMFPMediaPlayer::CreateMediaItemFromURL. Элемент мультимедиа должен использоваться с тем же объектом проигрывателя MFPlay, который создал этот элемент. Если элемент мультимедиа был создан другим экземпляром объекта проигрывателя, SetMediaItem возвращает E_INVALIDARG.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	mfplay.h

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

IMFPMediaPlayer

Использование MFPlay для воспроизведения звука и видео