Share via

Função MFGetWorkQueueMMCSSClass (mfapi.h)

  • Artigo

Recupera a classe MMCSS (Serviço de Agendador de Classe Multimídia) atualmente associada a essa fila de trabalho.

Sintaxe

HRESULT MFGetWorkQueueMMCSSClass(
  [in]      DWORD  dwWorkQueueId,
  [out]     LPWSTR pwszClass,
  [in, out] DWORD  *pcchClass
);

Parâmetros

[in] dwWorkQueueId

Identificador da fila de trabalho. O identificador é recuperado pela função MFAllocateWorkQueue .

[out] pwszClass

Ponteiro para um buffer que recebe o nome da classe MMCSS. Este parâmetro pode ser NULL.

[in, out] pcchClass

Na entrada, especifica o tamanho do buffer pwszClass, em caracteres . Na saída, recebe o tamanho necessário do buffer, em caracteres. O tamanho inclui o caractere nulo de terminação.

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 A função foi bem-sucedida.
MF_E_BUFFERTOOSMALL
 O buffer pwszClass é muito pequeno para receber o nome da tarefa.

Comentários

Se a fila de trabalho não estiver associada a uma tarefa MMCSS, a função recuperará uma cadeia de caracteres vazia.

Para associar uma fila de trabalho a uma tarefa MMCSS, chame MFBeginRegisterWorkQueueWithMMCSS.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation

Filas de Trabalho