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

Статья
08/24/2023

Связывает рабочую очередь с задачей службы планировщика мультимедийных классов (MMCSS).

Синтаксис

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

Параметры

[in] dwWorkQueueId

Идентификатор рабочей очереди. Для частных рабочих очередей идентификатор возвращается функцией MFAllocateWorkQueue . Сведения о рабочих очередях платформы см. в разделе Идентификаторы рабочих очередей.

[in] wszClass

Имя задачи MMCSS. Дополнительные сведения см. в разделе Служба планировщика мультимедийных классов.

[in] dwTaskId

Уникальный идентификатор задачи. Чтобы получить новый идентификатор задачи, присвойте этому значению нулевое значение.

[in] lPriority

Базовый относительный приоритет для потоков рабочей очереди. Дополнительные сведения см. в разделе AvSetMmThreadPriority.

[in] pDoneCallback

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

[in] pDoneState

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

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Эта функция является асинхронной. После завершения операции вызывается метод IMFAsyncCallback::Invoke объекта обратного вызова. На этом этапе вызовите MFEndRegisterWorkQueueWithMMCSS , чтобы завершить асинхронный запрос.

Чтобы отменить регистрацию рабочей очереди в задаче MMCSS, вызовите MFBeginUnregisterWorkQueueWithMMCSS.

Требования

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

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

Функции Media Foundation

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

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

Share via