Partilhar via


Função PsQuerySystemAvailableCpusCount (wdm.h)

A função PsQuerySystemAvailableCpusCount consulta a contagem de CPUs que estão disponíveis para o processo do sistema.

Sintaxe

NTSTATUS PsQuerySystemAvailableCpusCount(
  [out] PULONG   AvailableCpuCount,
  [out] PULONG64 SequenceNumber
);

Parâmetros

[out] AvailableCpuCount

Ponteiro para um buffer que receberá a contagem de CPUs disponíveis para o processo do sistema.

[out] SequenceNumber

Ponteiro para um buffer que receberá o número de sequência atual das CPUs disponíveis para o processo do sistema.

Valor de retorno

PsQuerySystemAvailableCpusCount retorna um valor NTSTATUS. Os valores de retorno possíveis incluem:

Código de retorno Descrição
STATUS_SUCCESS A consulta foi concluída com êxito.
STATUS_INVALID_PARAMETER Qualquer um dos parâmetros necessários é NULL.

Observações

Essa rotina pode ser chamada no IRQL de PASSIVE_LEVEL para DISPATCH_LEVEL.

Essa função fornece uma alternativa mais simples ao PsQuerySystemAvailableCpus quando apenas a contagem de CPUs disponíveis é necessária, em vez das informações detalhadas de afinidade.

O número de sequência permite que os chamadores acompanhem as alterações na disponibilidade da CPU e possam ser usados com PsQuerySystemAvailableCpus para consultas otimizadas.

Essa função consulta a disponibilidade da CPU para o processo do sistema, que normalmente representa todas as CPUs disponíveis no sistema.

Requisitos

Requisito Valor
cabeçalho wdm.h
IRQL PASSIVE_LEVEL to DISPATCH_LEVEL

Consulte também

PsQuerySystemAvailableCpus

PsQueryProcessAvailableCpusCount