Fonction ReadControlSpace64 (wdbgexts.h)

La fonction ReadControlSpace64 lit l’espace de contrôle spécifique au processeur dans le tableau pointé par buf.

Syntaxe

void ReadControlSpace64(
  USHORT  processor,
  ULONG64 address,
  PVOID   buf,
  ULONG   size
);

Paramètres

processor

Spécifie le numéro du processeur dont l’espace de contrôle doit être lu.

address

Spécifie l’adresse de l’espace de contrôle.

buf

Spécifie l’adresse d’un tableau d’octets pour contenir les données d’espace de contrôle.

size

Spécifie le nombre d’octets dans le tableau pointé vers par buf.

Valeur de retour

None

Remarques

Si vous écrivez du code 32 bits, vous devez utiliser ReadControlSpace à la place. Pour plus d’informations, consultez Pointeurs 32 bits et Pointeurs 64 bits .

Si vous écrivez une extension WdbgExts, incluez wdbgexts.h. Si vous écrivez une extension DbgEng qui appelle cette fonction, incluez wdbgexts.h avant dbgeng.h (pour plus d’informations, consultez Écriture du code d’extension DbgEng ).

La macro ReadTypedControlSpace32 est un wrapper mince autour de la fonction ReadControlSpace64 . Il est fourni pour faciliter la lecture de l’espace de contrôle spécifique au processeur dans une structure.

void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Spécifie le numéro du processeur dont l’espace de contrôle doit être lu.

_Addr

Spécifie l’adresse de l’espace de contrôle.

_Buf

Spécifie l’objet dans lequel les données d’espace de contrôle sont lues.

Valeur de retour

Cette macro ne retourne pas de valeur.

Les paramètres fournis à cette macro sont les mêmes que ceux fournis à la fonction ReadControlSpace64 , sauf qu’au lieu de fournir un pointeur vers une structure et sa taille, la structure peut être fournie directement.

La macro ReadTypedControlSpace64 est un wrapper mince autour de la fonction ReadControlSpace64 . Il est fourni pour faciliter la lecture de l’espace de contrôle spécifique au processeur dans une structure.

void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Spécifie le numéro du processeur dont l’espace de contrôle doit être lu.

_Addr

Spécifie l’adresse de l’espace de contrôle.

_Buf

Spécifie l’objet dans lequel les données d’espace de contrôle sont lues.

Valeur de retour

Cette macro ne retourne pas de valeur.

Les paramètres fournis à cette macro sont les mêmes que ceux fournis à la fonction ReadControlSpace64 , sauf qu’au lieu de fournir un pointeur vers une structure et sa taille, la structure peut être fournie directement.

Configuration requise

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