Compartilhar via


Função PsQueryProcessAvailableCpusCount (wdm.h)

A função PsQueryProcessAvailableCpusCount consulta a contagem de CPUs que estão disponíveis para um determinado processo ser executado.

Sintaxe

NTSTATUS PsQueryProcessAvailableCpusCount(
  [in]  PEPROCESS Process,
  [out] PULONG    AvailableCpuCount,
  [out] PULONG64  SequenceNumber
);

Parâmetros

[in] Process

Ponteiro para um processo (PEPROCESS).

[out] AvailableCpuCount

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

[out] SequenceNumber

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

Valor de retorno

PsQueryProcessAvailableCpusCount 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 PsQueryProcessAvailableCpus 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 PsQueryProcessAvailableCpus para consultas otimizadas.

Requisitos

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

Consulte também

PsQueryProcessAvailableCpus

PsQuerySystemAvailableCpusCount