Função GetNumaNodeProcessorMask (winbase.h)

Artigo
08/27/2023

Recupera a máscara de processador para o nó especificado.

Sintaxe

BOOL GetNumaNodeProcessorMask(
  [in]  UCHAR      Node,
  [out] PULONGLONG ProcessorMask
);

Parâmetros

[in] Node

O número do nó.

[out] ProcessorMask

A máscara do processador para o nó. Uma máscara de processador é um vetor de bits no qual cada bit representa um processador e se está no nó.

Se o nó não tiver processadores configurados, a máscara de processador será zero.

Em sistemas com mais de 64 processadores, esse parâmetro será definido como a máscara de processador para o nó somente se o nó estiver no mesmo grupo de processadores que o thread de chamada. Caso contrário, o parâmetro será definido como zero.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para recuperar o nó numerado mais alto do sistema, use a função GetNumaHighestNodeNumber . Observe que esse número não tem garantia de ser igual ao número total de nós no sistema.

Para garantir que todos os threads do processo sejam executados no mesmo nó, use a função SetProcessAffinityMask com uma máscara de afinidade de processo que especifica processadores no mesmo nó.

Use a função GetNumaNodeProcessorMaskEx para recuperar a máscara de processador de um nó em qualquer grupo de processadores.

Observação

A partir do Ferro de Versão tbd, o comportamento dessa e de outras funções NUMA foi modificado para dar melhor suporte a sistemas com nós que contêm mais de 64 processadores. Para obter mais informações sobre essa alteração, incluindo informações sobre como habilitar o comportamento antigo dessa API, consulte Suporte numa.

Comportamento começando com ferro de versão tbd

Cada nó recebe um grupo primário pelo sistema. A máscara retornada por GetNumaNodeProcessorMask é para o grupo primário do nó e só será retornada se o thread de chamada pertencer a esse grupo.

Comportamento em versões anteriores

A máscara para o nó especificado é retornada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP Professional x64 Edition, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll