KeRevertToUserAffinityThreadEx 函式 (wdm.h)
KeRevertToUserAffinityThreadEx 例程會還原目前線程的先前親和性。
語法
void KeRevertToUserAffinityThreadEx(
[in] KAFFINITY Affinity
);
參數
[in] Affinity
KAFFINITY 型別變數，指定目前線程的新系統親和性。 將此參數設定為先前呼叫 KeSetSystemAffinityThreadEx 例程所傳回的值。
傳回值
無
備註
KeRevertToUserAffinityThreadEx 會變更目前線程的親和性。 同質值是一個遮罩，可識別線程可執行的一組處理器。 如果成功，例程會排程線程在此集合中的處理器上執行。
如果 Affinity 值為非零值， KeRevertToUserAffinityThreadEx 會將線程的 affinity mask 設定為 Affinity 值。 如果 Affinity 值為零， KeRevertToUserAffinityThreadEx 會還原線程的原始使用者親和性遮罩。 這個原始用戶親和性遮罩是透過先前呼叫KeSetSystemAffinityThreadEx儲存在線程物件中。 除非呼叫 KeSetSystemAffinityThreadEx 之前呼叫 KeSetSystemAffinityThreadEx，否則呼叫 KeRevertToUserAffinityThreadEx 沒有任何作用。
如果 Affinity 值為非零值，則只有在下列兩者都成立時，例程才會將目前線程的 affinity 遮罩變更為 Affinity 值：
- Affinity 值為有效的 (也就是說，只會設定對應至邏輯處理器的遮罩位) 。
- 至少一個 在 Affinity 值中指定的處理器為使用中。
Windows 7 和更新版本的 Windows 支援處理器群組。 設計來處理處理器群組相關信息的驅動程序應該使用 KeRevertToUserGroupAffinityThread 例程，其會指定處理器群組，而不是 KeRevertToUserAffinityThreadEx，這不會。 不過，在 Windows 7 和更新版本的 Windows 中實作 KeRevertToUserAffinityThreadEx ，可為舊版 Windows 所撰寫的驅動程式提供相容性，而這些驅動程式不支持處理器群組。 在此實作中，非零 親和性 值是一個相似性遮罩，可在線程可執行的群組0中指定一組邏輯處理器。 如果 Affinity 為零，線程會還原為其原始的使用者模式組號和親和性遮罩。
如果在 IRQL <= APC_LEVEL 呼叫 KeRevertToUserAffinityThreadEx 且呼叫成功，則新 (還原) 親和性遮罩會立即生效。 當呼叫傳回時，呼叫線程已在新的同質遮罩中指定的處理器上執行。 如果在 IRQL = DISPATCH_LEVEL呼叫 KeRevertToUserAffinityThreadEx ，且呼叫成功，則擱置的處理器變更會延後，直到呼叫端降低低於DISPATCH_LEVEL的 IRQL 為止。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 和更新版本的 Windows。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (请参阅一节) 。 |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm) |