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) |