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

Статья
08/24/2023

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

Синтаксис

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

Параметры

[in] dwWorkQueueId

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

[in] wszClass

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

[in] dwTaskId

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

[in] pDoneCallback

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

[in] pDoneState

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

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

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

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

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

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

Требования


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

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

Функции Media Foundation

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