Функция MFScheduleWorkItem (mfapi.h)

  • Статья

Планирует выполнение асинхронной операции через указанный интервал.

Синтаксис

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

Параметры

[in] pCallback

Указатель на интерфейс IMFAsyncCallback . Вызывающий объект должен реализовать этот интерфейс.

[in] pState

Указатель на интерфейс IUnknown объекта состояния, определенного вызывающим объектом. Этот параметр может принимать значение NULL. Этот объект можно использовать для хранения сведений о состоянии. Объект возвращается вызывающей объекту при вызове обратного вызова.

[in] Timeout

Интервал времени ожидания в миллисекундах. Задайте для этого параметра отрицательное значение. Обратный вызов вызывается после -Timeout миллисекунда. Например, если время ожидания равно -5000, обратный вызов вызывается через 5000 миллисекунда.

[out] pKey

Получает ключ, который можно использовать для отмены таймера. Чтобы отменить таймер, вызовите MFCancelWorkItem и передайте этот ключ в параметре Key .

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

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

Код возврата Описание
S_OK
 Функция выполнена успешно.

Комментарии

Эта функция создает асинхронный результирующий объект. По истечении интервала таймера вызывается метод IMFAsyncCallback::Invoke , заданный pCallback .

Эта функция доступна на следующих платформах, если установлены распространяемые компоненты пакета 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 [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header mfapi.h
Библиотека Mfplat.lib
DLL Mfplat.dll

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

MFScheduleWorkItemEx

Функции Media Foundation

Рабочие очереди