Partager via


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

La méthode ReadPhysical2 lit la mémoire de la cible à partir de l’adresse physique spécifiée.

Syntaxe

HRESULT ReadPhysical2(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Paramètres

[in] Offset

Spécifie l’adresse physique de la mémoire à lire.

[in] Flags

Spécifie les propriétés de la mémoire physique à lire. Cela doit correspondre à la façon dont la mémoire physique a été annoncée sur le système d’exploitation sur la cible. Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeur Description
DEBUG_PHYSICAL_DEFAULT Utilisez la mise en cache de la mémoire par défaut.
DEBUG_PHYSICAL_CACHED La mémoire physique est mise en cache.
DEBUG_PHYSICAL_UNCACHED La mémoire physique n’est pas mise en cache.
DEBUG_PHYSICAL_WRITE_COMBINED La mémoire physique est combinée en écriture.

[out] Buffer

Reçoit la mémoire qui est lue.

[in] BufferSize

Spécifie la taille, en octets, de la mémoire tampon . Il s’agit du nombre maximal d’octets à lire.

[out, optional] BytesRead

Reçoit le nombre d’octets lus à partir de la mémoire de la cible. Si BytesRead 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.

Les indicateurs DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED et DEBUG_PHYSICAL_WRITE_COMBINED ne peuvent être utilisés que lorsque la cible est une cible de noyau dynamique qui est déboguée de manière standard (à l’aide d’un port COM, d’un bus 1394 ou d’un canal nommé).

Configuration requise

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

Voir aussi

IDebugDataSpaces4

ReadPhysical

WritePhysical2