Função AvSetMmThreadCharacteristicsA (avrt.h)

  • Artigo

Associa o thread de chamada à tarefa especificada.

Sintaxe

AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
  [in]      LPCSTR  TaskName,
  [in, out] LPDWORD TaskIndex
);

Parâmetros

[in] TaskName

O nome da tarefa a ser executada. Esse nome deve corresponder ao nome de uma das subchaves da chave a seguirHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.

[in, out] TaskIndex

O identificador de tarefa exclusivo. Na primeira vez que essa função é chamada, esse valor deve ser 0 na entrada. O valor do índice é retornado na saída e pode ser usado como entrada em chamadas subsequentes.

Retornar valor

Se a função for bem-sucedida, ela retornará um identificador para a tarefa.

Se a função falhar, ela retornará 0. Para recuperar informações de erro estendidas, chame GetLastError.

Veja a seguir possíveis códigos de erro.

Código de retorno Descrição
ERROR_INVALID_TASK_INDEX
 TaskIndex não é 0 na primeira chamada ou não é um valor reconhecido (em chamadas subsequentes).
ERROR_INVALID_TASK_NAME
 A tarefa especificada não corresponde a nenhuma das tarefas armazenadas no registro.
ERROR_PRIVILEGE_NOT_HELD
 O chamador não tem privilégios suficientes.

Comentários

Quando a tarefa for concluída, chame a função AvRevertMmThreadCharacteristics .

Observação

O cabeçalho avrt.h define AvSetMmThreadCharacteristics como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
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 avrt.h
Biblioteca Avrt.lib
DLL Avrt.dll

Confira também

Serviço agendador de classe multimídia