共用方式為

KeGetProcessorNumberFromIndex 函式 （ntifs.h）

  • 發行項

KeGetProcessorNumberFromIndex 例程會將全系統處理器索引轉換成群組編號和群組相對處理器編號。

語法

NTSTATUS KeGetProcessorNumberFromIndex(
  [in]  ULONG             ProcIndex,
  [out] PPROCESSOR_NUMBER ProcNumber
);

參數

[in] ProcIndex

全系統處理器索引。 如果多處理器系統包含 n 邏輯處理器的 總計，有效的處理器索引範圍從 0 到 n-1。

[out] ProcNumber

呼叫端配置的 PROCESSOR_NUMBER 結構的指標，例程會將 ProcIndex所識別之處理器的群組編號和群組相對處理器編號寫入其中。

傳回值

如果呼叫成功，KeGetProcessorNumberFromIndex 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列專案：

傳回碼 描述
STATUS_INVALID_PARAMETER
 ProcIndex 參數值不是有效的處理器索引。

言論

此例程接受輸入處理器索引，以識別整個多處理器系統的處理器。 輸出值是 PROCESSOR_NUMBER 結構，可依其群組內的組號和處理器編號來識別處理器。

例如，如果多處理器系統包含兩個群組，而每個群組包含64個邏輯處理器，則每個群組中的處理器編號範圍從0到63，但全系統的處理器索引範圍從0到127。

若要取得系統中的作用中邏輯處理器總數，請呼叫 KeQueryActiveProcessorCountEx 例程。

KeGetProcessorIndexFromNumber 例程會將群組編號和群組相對處理器編號轉換為全系統處理器索引。

例子

下列程式代碼範例使用 KeQueryActiveProcessorCountEx 和 KeGetProcessorNumberFromIndex 例程來列舉系統中所有作用中的邏輯處理器：

ULONG Count;
ULONG ProcIndex;
PROCESSOR_NUMBER ProcNumber;

Count = KeQueryActiveProcessorCountEx(ALL_PROCESSOR_GROUPS);
for (ProcIndex = 0; ProcIndex < Count; ProcIndex += 1)
{
    KeGetProcessorNumberFromIndex(ProcIndex, &ProcNumber);

    // Do something with the contents of ProcNumber.
    ...
}

常數值ALL_PROCESSOR_GROUPS定義於 Winnt.h 和 Ntdef.h 中。

要求

要求 價值
最低支援的用戶端 Windows 7
目標平臺 普遍
標頭 ntifs.h （include Ntddk.h， Wdm.h， Ntddk.h， Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何層級

另請參閱

KeGetProcessorIndexFromNumber

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER