KeGetProcessorIndexFromNumber 函式 (ntifs.h)

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

語法

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

[in] ProcNumber

呼叫端配置的 PROCESSOR_NUMBER 結構的指標，其中包含組號和群組相對處理器編號。

如果呼叫成功，KeGetProcessorIndexFromNumber 會傳回全系統處理器索引。如果 ProcNumber 指向無效 的PROCESSOR_NUMBER 值，例程會傳回INVALID_PROCESSOR_INDEX，此檔案定義於 Wdm.h 頭檔中。

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

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

若要取得系統中作用中邏輯處理器的總數，請呼叫 KeQueryActiveProcessorCountEx 例程，並將此例程的 GroupNumber 參數設定為 ALL_PROCESSOR_GROUPS。

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