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

Связывает рабочую очередь с задачей планировщика мультимедиа (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

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

[in] pDoneState

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

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

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

Замечания

Эта функция расширяет функцию MFBeginRegisterWorkQueueWithMMCSS , добавив параметр lPriority .

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

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

Требования

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

См. также

Функции Media Foundation

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

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