PREAD_PROCESS_MEMORY_ROUTINE fonction de rappel (dbghelp.h)

Article
02/29/2024

Fonction de rappel définie par l’application utilisée avec la fonction StackWalk64 . Elle est appelée lorsque StackWalk64 doit lire la mémoire à partir de l’espace d’adressage du processus.

Le type PREAD_PROCESS_MEMORY_ROUTINE64 définit un pointeur vers cette fonction de rappel. ReadProcessMemoryProc64 est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

PREAD_PROCESS_MEMORY_ROUTINE PreadProcessMemoryRoutine;

BOOL PreadProcessMemoryRoutine(
  [in]  HANDLE hProcess,
  [in]  DWORD lpBaseAddress,
  [out] PVOID lpBuffer,
  [in]  DWORD nSize,
  [out] PDWORD lpNumberOfBytesRead
)
{...}

Paramètres

[in] hProcess

Handle du processus pour lequel la trace de pile est générée.

[in] lpBaseAddress

Adresse de base de la mémoire à lire.

[out] lpBuffer

Pointeur vers une mémoire tampon qui reçoit la mémoire à lire.

[in] nSize

Taille de la mémoire à lire, en octets.

[out] lpNumberOfBytesRead

Pointeur vers une variable qui reçoit le nombre d’octets réellement lus.

Valeur retournée

Si la fonction réussit, la valeur de retour doit être TRUE. Si la fonction échoue, la valeur de retour doit être FALSE.

Remarques

Dans de nombreux cas, cette fonction peut mieux traiter le rappel avec un appel correspondant à ReadProcessMemory.

Cette fonction doit lire autant de mémoire que possible. La fonction StackWalk64 gère le cas où seule une partie de la mémoire demandée est lue.

Cette fonction de rappel remplace la fonction de rappel PREAD_PROCESS_MEMORY_ROUTINE . PREAD_PROCESS_MEMORY_ROUTINE est défini comme suit dans Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define PREAD_PROCESS_MEMORY_ROUTINE PREAD_PROCESS_MEMORY_ROUTINE64
#else
typedef
BOOL
(__stdcall *PREAD_PROCESS_MEMORY_ROUTINE)(
    __in HANDLE hProcess,
    __in DWORD lpBaseAddress,
    __out_bcount(nSize) PVOID lpBuffer,
    __in DWORD nSize,
    __out PDWORD lpNumberOfBytesRead
    );
#endif

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	dbghelp.h
Composant redistribuable	DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

ReadProcessMemory

StackWalk64

Partager via