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。 可能的錯誤傳回值包括：

傳回碼	Description
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
目標平台	Universal
標頭	ntifs.h (包含 Ntddk.h、Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	任何層級

另請參閱

KeGetProcessorIndexFromNumber

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER