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

Article
08/07/2023

La méthode WritePhysical2 écrit des données dans l’adresse physique spécifiée dans la mémoire de la cible.

Syntaxe

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

Paramètres

[in] Offset

Spécifie l’adresse physique de la mémoire dans laquelle écrire les données.

[in] Flags

Spécifie les propriétés de la mémoire physique dans laquelle écrire. 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.

[in] Buffer

Spécifie les données à écrire.

[in] BufferSize

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

[out, optional] BytesWritten

Reçoit le nombre d’octets écrits dans la mémoire de la cible. Si BytesWritten 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.

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