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

Article
02/26/2024

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é).