Partilhar via


Função set_task_execution_resources

Restringe os recursos de execução usados por threads de trabalho internas de tempo de execução de simultaneidade ao conjunto de afinidade especificado.

É válido chamar este método apenas antes que o Gerenciador de Recursos seja criado, ou entre dois tempos de vida do Gerenciador de Recursos. Pode ser chamado várias vezes enquanto o Gerenciador de Recursos não existir no momento da invocação. Depois que um limite de afinidade foi definido, permanece em vigor até a chamada válido seguinte ao método de set_task_execution_resources .

A máscara de afinidade forneceu não precisa ser um subconjunto de máscara de afinidade de processo. A afinidade do processo será atualizada se necessário.

void __cdecl set_task_execution_resources(
   DWORD_PTR _ProcessAffinityMask
);

void __cdecl set_task_execution_resources(
   unsigned short _Count,
   PGROUP_AFFINITY _PGroupAffinity
);

Parâmetros

  • _ProcessAffinityMask
    A máscara de afinidade que os threads de trabalho de tempo de execução de simultaneidade devem ser restrita a. Use este método em um sistema com maior que 64 threads de hardware somente se você quiser limitar o tempo de execução de simultaneidade a um subconjunto do grupo de processadores atual. Em geral, você deve usar a versão do método que aceita uma matriz de afinidades do grupo como um parâmetro, para restringir a afinidade em computadores com maior que 64 threads de hardware.

  • _Count
    O número de entradas de GROUP_AFFINITY na matriz especificada pelo parâmetro _PGroupAffinity.

  • _PGroupAffinity
    Uma matriz de entradas de GROUP_AFFINITY .

Comentários

O método lançará uma exceção de invalid_operation se um Gerenciador de Recursos a presente é invocado no momento, e uma exceção de invalid_argument se a afinidade especificada resultados em um conjunto vazio de recursos.

A versão do método que usa uma matriz de afinidades do grupo como um parâmetro só deve ser usado em sistemas operacionais Windows com o versão 7 ou superior. Caso contrário, uma exceção de invalid_operation é gerada.

De maneira programática que altera a afinidade do processo depois que esse método foi chamado não fará com que o Gerenciador de Recursos reavalie a afinidade que é restrito a. Como consequência, todas as alterações à afinidade do processo devem ser feitas antes de chamar este método.

Requisitos

Cabeçalho: concrt.h

Namespace: simultaneidade

Consulte também

Referência

Namespace Concurrency