Função AvSetMmMaxThreadCharacteristicsA (avrt.h)
Associa o thread de chamada às tarefas especificadas.
Sintaxe
AVRTAPI HANDLE AvSetMmMaxThreadCharacteristicsA(
[in] LPCSTR FirstTask,
[in] LPCSTR SecondTask,
[in, out] LPDWORD TaskIndex
);
Parâmetros
[in] FirstTask
O nome da primeira 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] SecondTask
O nome da segunda 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 |
|---|---|
|
TaskIndex não é 0 na primeira chamada ou não é um valor reconhecido (em chamadas subsequentes). |
|
A tarefa especificada não corresponde a nenhuma das tarefas armazenadas no registro. |
|
O chamador não tem privilégios suficientes. |
Comentários
As características resultantes do thread que executa as tarefas refletem a tarefa com a prioridade mais alta.
Quando a tarefa for concluída, chame a função AvRevertMmThreadCharacteristics .
Observação
O cabeçalho avrt.h define AvSetMmMaxThreadCharacteristics 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 |