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 seguir HKEY_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 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 |
|---|---|
|
O TaskIndex não é 0 na primeira chamada ou não é reconhecido (em chamadas subsequentes). |
|
A tarefa especificada não corresponde a nenhuma das tarefas armazenadas no Registro. |
|
O chamador não tem privilégio suficiente. |
Observações
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.
Nota
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 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 |