Função GetProcessAffinityMask (winbase.h)

Artigo
08/27/2023

Recupera a máscara de afinidade de processo para o processo especificado e a máscara de afinidade do sistema para o sistema.

Sintaxe

BOOL GetProcessAffinityMask(
  [in]  HANDLE     hProcess,
  [out] PDWORD_PTR lpProcessAffinityMask,
  [out] PDWORD_PTR lpSystemAffinityMask
);

Parâmetros

[in] hProcess

Um identificador para o processo cuja máscara de afinidade é desejada.

Esse identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION . Para obter mais informações, consulte Direitos de acesso e segurança do processo.

Windows Server 2003 e Windows XP: O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION .

[out] lpProcessAffinityMask

Um ponteiro para uma variável que recebe a máscara de afinidade para o processo especificado.

[out] lpSystemAffinityMask

Um ponteiro para uma variável que recebe a máscara de afinidade para o sistema.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero e a função definirá as variáveis apontadas por lpProcessAffinityMask e lpSystemAffinityMask para as máscaras de afinidade apropriadas.

Em um sistema com mais de 64 processadores, se os threads do processo de chamada estiverem em um único grupo de processadores, a função definirá as variáveis apontadas por lpProcessAffinityMask e lpSystemAffinityMask para a máscara de afinidade de processo e a máscara de processador de processadores lógicos ativos para esse grupo. Se o processo de chamada contiver threads em vários grupos, a função retornará zero para ambas as máscaras de afinidade.

Se a função falhar, o valor retornado será zero e os valores das variáveis apontadas por lpProcessAffinityMask e lpSystemAffinityMask serão indefinidos. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Uma máscara de afinidade de processo é um vetor de bits no qual cada bit representa os processadores nos quais um processo tem permissão para ser executado. Uma máscara de afinidade do sistema é um vetor de bits no qual cada bit representa os processadores configurados em um sistema.

Uma máscara de afinidade de processo é um subconjunto da máscara de afinidade do sistema. Um processo só tem permissão para ser executado nos processadores configurados em um sistema. Portanto, a máscara de afinidade de processo não pode especificar um 1 bit para um processador quando a máscara de afinidade do sistema especifica um 0 bit para esse processador.

A partir do Windows 11 e do Windows Server 2022, em um sistema com mais de 64 processadores, afinidades de processo e thread abrangem todos os processadores no sistema, em todos os grupos de processadores, por padrão. A função GetProcessAffinityMask define lpProcessAffinityMask e lpSystemAffinityMask como o processo e as máscaras de processador do sistema sobre o grupo primário do processo. Se o processo tiver definido explicitamente a afinidade de um ou mais de seus threads fora do grupo primário do processo, a função retornará zero para ambas as máscaras de afinidade. Se, no entanto, hHandle especificar um identificador para o processo atual, a função sempre usará o grupo primário do thread de chamada (que, por padrão, é o mesmo que o grupo primário do processo) para definir lpProcessAffinityMask e lpSystemAffinityMask.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll