Compartilhar via

Método IMFRealTimeClientEx::RegisterThreadsEx (mfidl.h)

  • Artigo

Notifica o objeto para registrar seus threads de trabalho com o MMCSS (Serviço de Agendador de Classe Multimídia).

Sintaxe

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

Parâmetros

[in, out] pdwTaskIndex

O identificador de tarefa MMCSS. Se o valor for zero na entrada, o objeto deverá criar um novo grupo de tarefas MCCSS. Consulte Observações.

[in] wszClassName

O nome da tarefa MMCSS.

[in] lBasePriority

A prioridade base do thread.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o objeto não criar threads de trabalho, o método deverá simplesmente retornar S_OK e não executar nenhuma ação adicional.

Caso contrário, se o valor de *pdwTaskIndex for zero na entrada, o objeto deverá executar as seguintes etapas:

  1. Um único thread de trabalho chama AvSetMmThreadCharacteristics para criar um novo identificador de tarefa MMCSS. Armazene esse valor.
  2. Quaisquer threads de trabalho adicionais chamam AvSetMmThreadCharacteristics usando o novo identificador de tarefa.
  3. Retorne o novo identificador de tarefa para o chamador, definindo *pdwTaskIndex igual ao identificador de tarefa.
Se o valor de for diferente de *pdwTaskIndex zero na entrada, o parâmetro conterá um identificador de tarefa MMCSS existente. Nesse caso, todos os threads de trabalho do objeto devem registrar-se para essa tarefa chamando AvSetMmThreadCharacteristics.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h

Confira também

IMFRealTimeClientEx

Melhorias na fila de trabalho e no threading