Partager via


PsQueryProcessAvailableCpusCount, fonction (wdm.h)

La fonction PsQueryProcessAvailableCpusCount interroge le nombre de processeurs disponibles pour un processus donné à exécuter.

Syntaxe

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

Paramètres

[in] Process

Pointeur vers un processus (PEPROCESS).

[out] AvailableCpuCount

Pointeur vers une mémoire tampon qui recevra le nombre de processeurs disponibles vers le processus donné.

[out] SequenceNumber

Pointeur vers une mémoire tampon qui recevra le numéro de séquence actuel pour les PROCESSEURs disponibles vers le processus donné.

Valeur retournée

PsQueryProcessAvailableCpusCount retourne une valeur NTSTATUS. Les valeurs de retour possibles sont les suivantes :

Code de retour Descriptif
STATUS_SUCCESS La requête a été effectuée avec succès.
STATUS_INVALID_PARAMETER L’un des paramètres requis est NULL.

Remarques

Cette routine peut être appelée à IRQL de PASSIVE_LEVEL à DISPATCH_LEVEL.

Cette fonction offre une alternative plus simple à PsQueryProcessAvailableCpus lorsque seul le nombre de processeurs disponibles est nécessaire, plutôt que les informations d’affinité détaillées.

Le numéro de séquence permet aux appelants de suivre les modifications de la disponibilité du processeur et peuvent être utilisés avec PsQueryProcessAvailableCpus pour les requêtes optimisées.

Spécifications

Besoin Valeur
En-tête wdm.h
IRQL PASSIVE_LEVEL à DISPATCH_LEVEL

Voir aussi

PsQueryProcessAvailableCpus

PsQuerySystemAvailableCpusCount