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 KAFFINITYtipada que especifica a nova afinidade de sistema do thread atual.

Valor de retorno

Nenhum

Observações

A implementação de KeSetSystemAffinityThread no Windows 7 e versões posteriores do Windows fornece compatibilidade para drivers que foram gravados para versões anteriores do Windows, que não dão suporte a grupos de processadores. Nesta 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
de cliente com suporte mínimo 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.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (consulte a seção Comentários).
regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

KAFFINITY

KeSetSystemAffinityThreadEx