IDebugDataSpaces4 ::ReadPhysical2, méthode (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 au 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 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 lue.
[in] BufferSize
Spécifie la taille, en octets, de la mémoire tampon mémoire tampon. Il s’agit du nombre maximal d’octets qui seront lus.
[out, optional] BytesRead
Reçoit le nombre d’octets lus à partir de la mémoire de la cible. Si BytesRead est NULL, ces informations ne sont pas retournées.
Valeur de retour
| Retourner le code | 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 actif en cours de débogage de la manière standard (à l’aide d’un port COM, d’un bus 1394 ou d’un canal nommé).
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dbgeng.h (include Dbgeng.h) |