PREAD_PROCESS_MEMORY_ROUTINE Rückruffunktion (dbghelp.h)
Eine anwendungsdefinierte Rückruffunktion, die mit der StackWalk64-Funktion verwendet wird. Sie wird aufgerufen, wenn StackWalk64 Arbeitsspeicher aus dem Adressraum des Prozesses lesen muss.
Der PREAD_PROCESS_MEMORY_ROUTINE64 Typ definiert einen Zeiger auf diese Rückruffunktion. ReadProcessMemoryProc64 ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
PREAD_PROCESS_MEMORY_ROUTINE PreadProcessMemoryRoutine;
BOOL PreadProcessMemoryRoutine(
[in] HANDLE hProcess,
[in] DWORD lpBaseAddress,
[out] PVOID lpBuffer,
[in] DWORD nSize,
[out] PDWORD lpNumberOfBytesRead
)
{...}
Parameter
[in] hProcess
Ein Handle für den Prozess, für den die Stapelüberwachung generiert wird.
[in] lpBaseAddress
Die Basisadresse des zu lesenden Speichers.
[out] lpBuffer
Ein Zeiger auf einen Puffer, der den zu lesenden Speicher empfängt.
[in] nSize
Die Größe des zu lesenden Arbeitsspeichers in Bytes.
[out] lpNumberOfBytesRead
Ein Zeiger auf eine Variable, die die Anzahl der tatsächlich gelesenen Bytes empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, sollte der Rückgabewert TRUE sein. Wenn die Funktion fehlschlägt, sollte der Rückgabewert FALSE sein.
Hinweise
In vielen Fällen kann diese Funktion den Rückruf am besten mit einem entsprechenden Aufruf von ReadProcessMemory verwalten.
Diese Funktion sollte so viel wie möglich aus dem angeforderten Arbeitsspeicher lesen. Die StackWalk64-Funktion behandelt den Fall, in dem nur ein Teil des angeforderten Arbeitsspeichers gelesen wird.
Diese Rückruffunktion ersetzt die PREAD_PROCESS_MEMORY_ROUTINE Rückruffunktion. PREAD_PROCESS_MEMORY_ROUTINE wird in Dbghelp.h wie folgt definiert.
#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
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |