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

Article
08/07/2023

La méthode GetOffsetInformation fournit des informations générales sur une adresse dans l’espace de données d’un processus.

Syntaxe

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Paramètres

[in] Space

Spécifie l’espace de données auquel s’applique le paramètre Offset . Les valeurs autorisées dépendent du paramètre Which .

[in] Which

Spécifie les informations sur les données qui sont interrogées. Cela détermine les valeurs possibles pour Espace et le type des données retournées dans La mémoire tampon. Les valeurs possibles sont les suivantes :

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Retourne la source de la mémoire virtuelle de la cible à décalage. C’est à partir de là que le moteur du débogueur lit la mémoire. L’espace doit être défini sur DEBUG_DATA_SPACE_VIRTUAL. Un ULONG est retourné à La mémoire tampon. Cet ULONG peut prendre les valeurs répertoriées dans le tableau suivant.

Valeur	Description
DEBUG_VSOURCE_INVALID	Le décalage de décalage n’est pas disponible dans l’espace d’adressage virtuel du processus. Cela peut signifier que l’adresse n’est pas valide ou que la mémoire n’est pas disponible. Par exemple, un fichier de vidage sur incident peut ne pas contenir toute la mémoire du processus ou du noyau.
DEBUG_VSOURCE_DEBUGGEE	La mémoire virtuelle au niveau du décalage est fournie par la cible.
DEBUG_VSOURCE_MAPPED_IMAGE	Le moteur de débogueur lit la mémoire virtuelle de la cible à l’emplacement Décalage d’un fichier image local. C’est souvent le cas dans les fichiers minidump où les images de module ne sont pas incluses dans le fichier de vidage et sont chargées par le moteur du débogueur.

[in] Offset

Spécifie le décalage dans l’espace de données de la cible pour lequel les informations sont retournées.

[out, optional] Buffer

Spécifie la mémoire tampon pour recevoir les informations. Le type des données retournées dépend de la valeur de Laquelle. Si La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille, en octets, de la mémoire tampon .

[out, optional] InfoSize

Reçoit la taille, en octets, des informations retournées. Si InfoSize a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.

Configuration requise

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

Partager via