Метод IMFMediaEventQueue::QueueEventParamVar (mfobjects.h)

Создает событие, задает PROPVARIANT в качестве данных события и помещает событие в очередь.

Вызовите этот метод в реализации IMFMediaEventGenerator::QueueEvent. Передайте параметры из этого метода непосредственно в этот метод.

Этот метод также можно вызвать, когда компоненту необходимо вызвать событие, не содержащее атрибутов. Если данные события являются указателем IUnknown , можно использовать IMFMediaEventQueue::QueueEventParamUnk. Если событие содержит атрибуты, используйте вместо него IMFMediaEventQueue::QueueEvent .

Синтаксис

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

Параметры

[in] met

Указывает тип события, добавляемого в очередь. Тип события возвращается методом IMFMediaEvent::GetType события. Список типов событий см. в разделе События Media Foundation.

[in] guidExtendedType

Расширенный тип события. Если событие не имеет расширенный тип, используйте значение GUID_NULL. Расширенный тип возвращается методом IMFMediaEvent::GetExtendedType события.

[in] hrStatus

Код успеха или сбоя, указывающий состояние события. Это значение возвращается методом IMFMediaEvent::GetStatus события.

[in] pvValue

Указатель на PROPVARIANT , содержащий значение события. Этот параметр может принимать значение NULL. Это значение возвращается методом IMFMediaEvent::GetValue события.

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

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

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

Комментарии

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета 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 mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

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

IMFMediaEventQueue