Função GetNumaProximityNode (winbase.h)

  • Artigo

Recupera o número do nó NUMA que corresponde ao identificador de domínio de proximidade especificado.

Use a função GetNumaProximityNodeEx para recuperar o número do nó como um valor USHORT .

Sintaxe

BOOL GetNumaProximityNode(
  [in]  ULONG  ProximityId,
  [out] PUCHAR NodeNumber
);

Parâmetros

[in] ProximityId

O identificador de domínio de proximidade do nó.

[out] NodeNumber

O número do nó. Se o processador não existir, esse parâmetro será 0xFF.

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

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, em que 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.

Requisitos

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

Confira também

GetNumaProcessorNode

GetNumaProximityNodeEx

Suporte ao NUMA