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 值中指定的處理器為使用中。
如果不符合上述任一條件， 則呼叫 KeRevertToUserAffinityThreadEx 沒有任何作用。

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)

另請參閱

KAFFINITY

KeRevertToUserGroupAffinityThread

KeSetSystemAffinityThreadEx