Méthode IDebugDataSpaces4 ::ReadProcessorSystemData (dbgeng.h)

Article
02/23/2024

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’exécution réussie, les données retournées dans la mémoire tampon ont le type spécifié par la colonne du milieu.

Valeur	Description
DEBUG_DATA_KPCR_OFFSET	Retourne l’adresse virtuelle de la région de contrôle du processeur (PCR) du processeur. Dans ce cas, l’argument Buffer peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_KPRCB_OFFSET	Retourne l’adresse virtuelle du bloc de contrôle du processeur (PRCB) du processeur. Dans ce cas, l’argument Buffer 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 Buffer 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 appartenant au système d’exploitation ou au processeur. L’adresse et le contenu à l’adresse dépendent du processeur et du système d’exploitation. Dans ce cas, l’argument Buffer peut être considéré comme ayant un type PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Retourne une description du processeur. Dans ce cas, l’argument Buffer 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 Buffer 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, il est possible d’accéder au contenu de cette mémoire tampon en castant Buffer vers le type spécifié dans le tableau ci-dessus.

[in] BufferSize

Spécifie la taille en octets de la mémoire 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 a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour	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 PCR, PRCB et KTHREAD, ainsi que sur les tables de pagination, consultez Microsoft Windows Internals de David Solomon et Mark Russinovich.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Partager via