Метод IMFAsyncResult::GetObject (mfobjects.h)

  • Статья

Возвращает объект, связанный с асинхронной операцией. Тип объекта , если таковой имеется, зависит от вызываемого асинхронного метода.

Синтаксис

HRESULT GetObject(
  [out] IUnknown **ppObject
);

Параметры

[out] ppObject

Получает указатель на интерфейс IUnknown объекта. Если с операцией не связан ни объект, этот параметр получает значение NULL. Если значение не равно NULL, вызывающий объект должен освободить интерфейс.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 С этим асинхронным результатом не связан объект .

Комментарии

Как правило, этот объект используется компонентом, реализующим асинхронный метод. Он предоставляет функцию, которая вызывает обратный вызов, для передачи информации в асинхронный метод End... , который завершает операцию.

Если вы реализуете асинхронный метод, можно задать объект с помощью параметра punkObject функции MFCreateAsyncResult .

Если внутренний указатель IUnknown объекта асинхронного результата имеет значение NULL, метод возвращает E_POINTER.

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

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

Требования

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

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

Асинхронные методы обратного вызова

IMFAsyncResult