Função AvSetMmThreadCharacteristicsA (avrt.h)

Artigo
11/20/2024

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 seguir HKEY_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.

Valor de retorno

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.

A seguir estão possíveis códigos de erro.

Código de retorno	Descrição
ERROR_INVALID_TASK_INDEX	O TaskIndex não é 0 na primeira chamada ou não é 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égio suficiente.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	avrt.h
biblioteca	Avrt.lib
de DLL	Avrt.dll

Consulte também

de Serviço de Agendador de Classe Multimídia

Compartilhar via