Função GetNumaProximityNodeEx (systemtopologyapi.h)

Recupera o número do nó NUMA que corresponde ao identificador de proximidade especificado como um valor USHORT .

Sintaxe

BOOL GetNumaProximityNodeEx(
  [in]  ULONG   ProximityId,
  [out] PUSHORT NodeNumber
);

Parâmetros

[in] ProximityId

O identificador de proximidade do nó.

[out] NodeNumber

Aponta para uma variável para receber o número do nó do identificador de proximidade especificado.

Valor de retorno

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

Se a função falhar, o valor retornado será zero.

Observações

Um identificador de domínio de proximidade é um índice para um nó NUMA em um sistema NUMA. Identificadores de domínio de proximidade são encontrados na Tabela de Afinidade de Recursos do Sistema ACPI (SRAT), em que são usados para associar processadores e regiões de memória a um nó NUMA específico. Os identificadores de domínio de proximidade também são encontrados no namespace ACPI, onde são usados para associar um dispositivo a um nó NUMA específico. Os identificadores de domínio de proximidade normalmente são usados apenas por aplicativos de gerenciamento fornecidos pelos fabricantes do sistema. O Windows não usa identificadores de domínio de proximidade para identificar nós NUMA; em vez disso, ele atribui um número exclusivo a cada nó NUMA no sistema.

A distância relativa entre nós em um sistema é armazenada na Tabela de Informações de Distância da Localidade do Sistema ACPI (SLIT), que não é exposta por nenhuma função do Windows. Para obter mais informações sobre tabelas ACPI, consulte as especificações de ACPI.

A única diferença entre a função GetNumaProximityNodeEx e a função GetNumaProximityNode é o tipo de dados do parâmetro NodeNumber .

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.

Requirements

Consulte também

GetNumaProximityNode

Suporte a NUMA