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
| 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 |