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

Статья
08/24/2023

Помещает асинхронную операцию в рабочую очередь с указанным приоритетом.

Синтаксис

HRESULT MFPutWorkItem2(
  [in] DWORD            dwQueue,
  [in] LONG             Priority,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Параметры

[in] dwQueue

Идентификатор рабочей очереди. Это значение может указывать одну из стандартных рабочих очередей Media Foundation или рабочую очередь, созданную приложением. Список стандартных рабочих очередей Media Foundation см. в разделе Идентификаторы рабочих очередей. Чтобы создать новую рабочую очередь, вызовите MFAllocateWorkQueue или MFAllocateWorkQueueEx.

[in] Priority

Приоритет рабочего элемента. Рабочие элементы выполняются в порядке приоритета.

[in] pCallback

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

[in] pState

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

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата	Описание
S_OK	Успешно.
MF_E_INVALID_WORKQUEUE	Недопустимый идентификатор рабочей очереди.
MF_E_SHUTDOWN	Функция MFStartup не была вызвана, или была вызвана функция MFShutdown .

Требования


Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	mfapi.h
Библиотека	Mfplat.lib
DLL	Mfplat.dll

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

Функции Media Foundation

Улучшения рабочих очередей и потоков

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