IDebugDataSpaces4 ::ReadProcessorSystemData, méthode (dbgeng.h)

Article
02/06/2025

La méthode ReadProcessorSystemData retourne des données sur le processeur spécifié.

Syntaxe

HRESULT ReadProcessorSystemData(
  [in]            ULONG  Processor,
  [in]            ULONG  Index,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG DataSize
);

Paramètres

[in] Processor

Spécifie le processeur dont les données doivent être lues.

[in] Index

Spécifie le type de données à lire. Le tableau suivant contient les valeurs valides. Une fois l’opération terminée, les données retournées dans la mémoire tampon tampon ont le type spécifié par la colonne centrale.

Valeur	Description
DEBUG_DATA_KPCR_OFFSET	Retourne l’adresse virtuelle de la région de contrôle du processeur (RPC) du processeur. Dans ce cas, l’argument tampon peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_KPRCB_OFFSET	Retourne l’adresse virtuelle du bloc de contrôle de processeur du processeur (PRCB). Dans ce cas, l’argument tampon peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_KTHREAD_OFFSET	Retourne l’adresse virtuelle de la structure KTHREAD pour le thread système en cours d’exécution sur le processeur. Dans ce cas, l’argument tampon peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Retourne l’adresse virtuelle de la base des informations de pagination détenues par le système d’exploitation ou le processeur. L’adresse et le contenu à l’adresse sont dépendants du processeur et du système d’exploitation. Dans ce cas, l’argument tampon peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Retourne une description du processeur. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED	Retourne la vitesse du processeur en MHz. Cela peut ne pas fonctionner dans une session particulière. Dans ce cas, l’argument tampon peut être considéré comme ayant le type PULONG.

[out] Buffer

Reçoit les données du processeur. Une fois la méthode terminée, le contenu de cette mémoire tampon est accessible en cas de conversion de tampon sur le type spécifié dans le tableau ci-dessus.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon tampon. Il s’agit du nombre maximal d’octets qui seront retournés.

[out, optional] DataSize

Reçoit la taille des données en octets. Si DataSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Remarques

Cette méthode n’est disponible que dans le débogage en mode noyau.

Pour plus d’informations sur les structures RPC, PRCB et KTHREAD, ainsi que sur les tables de pagination, consultez Microsoft Windows Internals par David Salomon et Mark Russinovich.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Partager via