Поделиться через


Метод IMFRealTimeClientEx::RegisterThreadsEx (mfidl.h)

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

Синтаксис

HRESULT RegisterThreadsEx(
  [in, out] DWORD   *pdwTaskIndex,
  [in]      LPCWSTR wszClassName,
  [in]      LONG    lBasePriority
);

Параметры

[in, out] pdwTaskIndex

Идентификатор задачи MMCSS. Если значение равно нулю для входных данных, объект должен создать новую группу задач MCCSS. См. заметки.

[in] wszClassName

Имя задачи MMCSS.

[in] lBasePriority

Базовый приоритет потока.

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

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

Комментарии

Если объект не создает рабочие потоки, метод должен просто вернуть S_OK и не предпринимать никаких дальнейших действий.

В противном случае, если значение равно нулю *pdwTaskIndex для входных данных, объект должен выполнить следующие действия:

  1. Один рабочий поток вызывает AvSetMmThreadCharacteristics , чтобы создать идентификатор задачи MMCSS. Сохраните это значение.
  2. Все дополнительные рабочие потоки вызывают AvSetMmThreadCharacteristics , используя новый идентификатор задачи.
  3. Верните новый идентификатор задачи вызывающей объекту, задав *pdwTaskIndex значение равным идентификатору задачи.
Если для входных *pdwTaskIndex данных задано ненулевое значение, параметр содержит существующий идентификатор задачи MMCSS. В этом случае все рабочие потоки объекта должны зарегистрировать себя для этой задачи, вызвав AvSetMmThreadCharacteristics.

Требования

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

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

IMFRealTimeClientEx

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