Compartir a través de


Función PsQueryProcessAvailableCpusCount (wdm.h)

La función PsQueryProcessAvailableCpusCount consulta el recuento de CPU disponibles para que un proceso determinado se ejecute.

Sintaxis

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

Parámetros

[in] Process

Puntero a un proceso (PEPROCESS).

[out] AvailableCpuCount

Puntero a un búfer que recibirá el recuento de CPU disponibles para el proceso especificado.

[out] SequenceNumber

Puntero a un búfer que recibirá el número de secuencia actual de las CPU disponibles para el proceso especificado.

Valor devuelto

PsQueryProcessAvailableCpusCount devuelve un valor NTSTATUS. Entre los posibles valores devueltos se incluyen:

Código de retorno Descripción
STATUS_SUCCESS La consulta se completó correctamente.
STATUS_INVALID_PARAMETER Cualquiera de los parámetros necesarios es NULL.

Observaciones

Se puede llamar a esta rutina en IRQL desde PASSIVE_LEVEL hasta DISPATCH_LEVEL.

Esta función proporciona una alternativa más sencilla a PsQueryProcessAvailableCpus cuando solo se necesita el recuento de CPU disponibles, en lugar de la información detallada de afinidad.

El número de secuencia permite a los autores de llamadas realizar un seguimiento de los cambios en la disponibilidad de la CPU y se pueden usar con PsQueryProcessAvailableCpus para consultas optimizadas.

Requisitos

Requisito Importancia
encabezado wdm.h
irQL PASSIVE_LEVEL to DISPATCH_LEVEL

Consulte también

PsQueryProcessAvailableCpus

PsQuerySystemAvailableCpusCount