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ó para o identificador de proximidade especificado.

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

Um identificador de domínio de proximidade é um índice para um nó NUMA em um sistema NUMA. Os identificadores de domínio de proximidade são encontrados na SRAT (Tabela de Afinidade de Recurso do Sistema) do ACPI, 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, em que são usados para associar um dispositivo a um nó NUMA específico. 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 SLIT (Tabela de Informações de Distância da Localidade do Sistema) do ACPI, 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.

Requisitos

Confira também

GetNumaProximityNode

Suporte ao NUMA