Função GetNumaNodeProcessorMaskEx (systemtopologyapi.h)

Artigo
03/02/2024

Recupera a máscara de processador de um nó, independentemente do grupo de processadores ao qual o nó pertence.

Sintaxe

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

Parâmetros

[in] Node

O número do nó.

[out] ProcessorMask

Um ponteiro para uma estrutura GROUP_AFFINITY que recebe a máscara de processador para o nó especificado. Uma máscara de processador é um vetor de bits no qual cada bit representa um processador e se ele está no nó.

Se o nó especificado não tiver processadores configurados, o membro Mask será zero e o membro group será indefinido.

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.

Comentários

A função GetNumaNodeProcessorMaskEx difere de GetNumaNodeProcessorMask , pois pode recuperar a máscara do processador para um nó, independentemente do grupo ao qual o nó pertence. Ou seja, o nó não precisa estar no mesmo grupo que o thread de chamada. A função GetNumaNodeProcessorMask pode recuperar a máscara do processador somente para nós que estão no mesmo grupo que o thread de chamada.

Para recuperar o nó numerado mais alto no 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ó.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT>= 0x0601. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

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 contendo 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 a NUMA.

Comportamento começando com Ferro de Liberação TBD

Cada nó recebe um grupo primário pelo sistema. O GROUP_AFFINITY retornado por GetNumaNodeProcessorMaskEx é para o grupo primário do nó.

Comportamento em versões anteriores

A GROUP_AFFINITY do nó especificado é retornada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	systemtopologyapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll