GetNumaProximityNodeEx 関数 (systemtopologyapi.h)

  • [アーティクル]

指定した近接識別子に対応する NUMA ノード番号を USHORT 値として取得します。

構文

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

パラメーター

[in] ProximityId

ノードの近接識別子。

[out] NodeNumber

指定した近接識別子のノード番号を受け取る変数を指します。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

注釈

近接ドメイン識別子は、NUMA システム上の NUMA ノードへのインデックスです。 近接ドメイン識別子は、プロセッサとメモリ領域を特定の NUMA ノードに関連付けるために使用される ACPI システム リソース アフィニティ テーブル (SRAT) にあります。 近接ドメイン識別子は、ACPI 名前空間にも存在し、デバイスを特定の NUMA ノードに関連付けるために使用されます。 近接ドメイン識別子は、通常、システム製造元によって提供される管理アプリケーションでのみ使用されます。 Windows では、近接ドメイン識別子を使用して NUMA ノードを識別しません。代わりに、システム内の各 NUMA ノードに一意の番号を割り当てます。

システム上のノード間の相対距離は、WINDOWS 関数によって公開されない ACPI システムの局所性距離情報テーブル (SLIT) に格納されます。 ACPI テーブルの詳細については、 ACPI の仕様に関するページを参照してください。

GetNumaProximityNodeEx 関数と GetNumaProximityNode 関数の唯一の違いは、NodeNumber パラメーターのデータ型です。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT >= 0x0601を設定します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー systemtopologyapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

GetNumaProximityNode

NUMA サポート