ReadControlSpace64, fonction (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 nombre 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é par buf .

Valeur de retour

Aucun

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 (voir Écriture du code d’extension DbgEng pour plus d’informations).

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

void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Spécifie le nombre 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 identiques à 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 comme commodité pour lire l’espace de contrôle spécifique au processeur dans une structure.

void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Spécifie le nombre 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 identiques à 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.

Exigences

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