Compartilhar via


Função KeSetSystemAffinityThread (wdm.h)

A rotina KeSetSystemAffinityThread define a afinidade do sistema do thread atual.

Sintaxe

void KeSetSystemAffinityThread(
  [in] KAFFINITY Affinity
);

Parâmetros

[in] Affinity

Uma variável do tipo KAFFINITY que especifica a nova afinidade de sistema do thread atual.

Retornar valor

Nenhum

Comentários

A implementação de KeSetSystemAffinityThread no Windows 7 e versões posteriores do Windows fornece compatibilidade para drivers que foram escritos para versões anteriores do Windows, que não dão suporte a grupos de processadores. Nessa implementação, KeSetSystemAffinityThread atribui o thread ao grupo 0 e usa a máscara de afinidade para especificar um conjunto de processadores lógicos nesse grupo no qual o thread pode ser executado.

Se KeSetSystemAffinityThread for chamado em IRQL <= APC_LEVEL e a chamada for bem-sucedida, a nova máscara de afinidade entrará em vigor imediatamente. Quando a chamada retorna, o thread de chamada já está em execução em um processador especificado na nova máscara de afinidade. Se KeSetSystemAffinityThread for chamado em IRQL = DISPATCH_LEVEL e a chamada for bem-sucedida, a alteração pendente do processador será adiada até que o chamador reduza o IRQL abaixo DISPATCH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows. Use KeSetSystemAffinityThread somente em sistemas antes do Windows Vista. No Windows Vista e versões posteriores do sistema operacional Windows, use KeSetSystemAffinityThreadEx.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (consulte a seção Comentários).
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

KAFFINITY

KeSetSystemAffinityThreadEx