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