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

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

Синтаксис

HRESULT MFPutWorkItemEx2(
  [in] DWORD          dwQueue,
  [in] LONG           Priority,
  [in] IMFAsyncResult *pResult
);

Параметры

[in] dwQueue

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

[in] Priority

Приоритет рабочего элемента. Это значение должно иметь значение 1, 0 или -1. Элементы со значением 1 выполняются перед элементами со значением 0. Элементы со значением -1 выполняются после элементов со значением 0.

[in] pResult

Указатель на интерфейс МВФAsyncResult объекта асинхронного результата. Чтобы создать объект результата, вызовите MFCreateAsyncResult.

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

Возвращает значение HRESULT . Возможные значения включают следующие значения.

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

Замечания

Чтобы вызвать рабочий элемент, эта функция передает pResult функции MFInvokeCallback . Обратный вызов указывается при создании объекта результата, указанного pResult.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2012 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

См. также

Функции Media Foundation

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

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