KeSetSystemAffinityThread 函式 (wdm.h)

  • 發行項

KeSetSystemAffinityThread 例程會設定目前線程的系統親和性。

語法

void KeSetSystemAffinityThread(
  [in] KAFFINITY Affinity
);

參數

[in] Affinity

KAFFINITY 型別變數，指定目前線程的新系統親和性。

傳回值

無

備註

在 Windows 7 和更新版本中， KeSetSystemAffinityThread 的實作可為舊版 Windows 所撰寫的驅動程式提供相容性，這些驅動程式不支持處理器群組。 在此實作中， KeSetSystemAffinityThread 會將線程指派給群組 0，並使用同質遮罩來指定此群組中線程可執行的一組邏輯處理器。

如果在 IRQL <= APC_LEVEL呼叫 KeSetSystemAffinityThread，且呼叫成功，則新的親和性遮罩會立即生效。 當呼叫傳回時，呼叫線程已在新的同質遮罩中指定的處理器上執行。 如果在 IRQL = DISPATCH_LEVEL呼叫 KeSetSystemAffinityThread ，且呼叫成功，則擱置的處理器變更會延後，直到呼叫端降低下方的 IRQL DISPATCH_LEVEL為止。

規格需求

需求 值
最低支援的用戶端 可在 Windows 2000 和更新版本的 Windows 中使用。 只有在 Windows Vista 之前，才在系統上使用 KeSetSystemAffinityThread。 在 Windows Vista 和更新版本的 Windows 作業系統中，請改用 KeSetSystemAffinityThreadEx。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (请参阅一节) 。
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm)

另請參閱

KAFFINITY

KeSetSystemAffinityThreadEx