intestazione wdbgexts.h

Questa intestazione viene usata dal debugger. Per altre informazioni, vedere:

• Debugger

wdbgexts.h contiene le interfacce di programmazione seguenti:

Funzioni

GetCurrentProcessAddr La funzione GetCurrentProcessAddr restituisce il percorso dei dati di sistema che descrivono il processo corrente.
GetCurrentProcessHandle La funzione GetCurrentProcessHandle restituisce l'handle di sistema per il processo corrente.
GetCurrentThreadAddr La funzione GetCurrentThreadAddr restituisce la posizione dei dati di sistema che descrivono il thread corrente.
GetDebuggerCacheSize La funzione GetDebuggerCacheSize restituisce le dimensioni della cache utilizzata dal debugger per contenere i dati ottenuti dalla destinazione.
GetDebuggerData La funzione GetDebuggerData recupera le informazioni archiviate in un blocco di dati.
GetExpressionEx La funzione GetExpressionEx valuta un'espressione. L'espressione viene valutata usando l'analizzatore MASM e può contenere alias.
GetFieldData La funzione GetFieldData restituisce il valore di un membro in una struttura.
GetFieldOffset La funzione GetFieldOffset restituisce l'offset di un membro dall'inizio di una struttura.
GetFieldValue La macro GetFieldValue è un wrapper sottile intorno alla funzione GetFieldData. Viene fornito come comodità per leggere il valore di un membro in una struttura.
GetInputLine La funzione GetInputLine richiede una stringa di input dal debugger.
GetKdContext La funzione GetKdContext restituisce il numero totale di processori e il numero del processore corrente nella struttura a cui punta ppi.
GetPebAddress La funzione GetPebAddress restituisce l'indirizzo del blocco di ambiente del processo (PEB) per un processo di sistema.
GetSetSympath La funzione GetSetSympath può essere usata per ottenere o impostare il percorso di ricerca dei simboli.
GetShortField La funzione GetShortField legge il valore di un membro in una struttura se la dimensione è minore o uguale a 8 byte o inizializza una struttura in modo che possa essere letta in un secondo momento.
GetTebAddress La funzione GetTebAddress restituisce l'indirizzo del blocco di ambiente thread (TEB) per il thread del sistema operativo corrente.
GetTypeSize La funzione GetTypeSize restituisce le dimensioni nella memoria della destinazione di un'istanza del tipo specificato.
IsPtr64 La funzione IsPtr64 determina se la destinazione usa puntatori a 64 bit.
ListType La funzione ListType chiama una funzione di callback specificata per ogni elemento di un elenco collegato.
ReadControlSpace La funzione ReadControlSpace legge lo spazio di controllo specifico del processore nella matrice a cui punta buf.
ReadControlSpace64 La funzione ReadControlSpace64 legge lo spazio di controllo specifico del processore nella matrice a cui punta buf.
ReadIoSpace La funzione ReadIoSpace legge dai percorsi di I/O di sistema.
ReadIoSpace64 La funzione ReadIoSpace64 legge dalle posizioni di I/O di sistema.
ReadIoSpaceEx La funzione ReadIoSpaceEx è una versione estesa di ReadIoSpace.
ReadIoSpaceEx64 La funzione ReadIoSpaceEx64 è una versione estesa di ReadIoSpace64.
ReadListEntry La funzione ReadListEntry legge una voce dell'elenco collegato doubly dalla memoria della destinazione.
ReadMsr La funzione ReadMsr legge il contenuto di un Model-Specific Register (MSR).
ReadPhysical La funzione ReadPhysical legge dalla memoria fisica.
ReadPhysicalWithFlags La funzione ReadPhysicalWithFlags legge dalla memoria fisica.
ReadPointer La funzione ReadPointer legge un puntatore dalla destinazione.
ReadPtr La funzione ReadPtr legge un puntatore dalla destinazione. ReadPointer deve essere usato invece di questa funzione perché il valore restituito di ReadPointer è più coerente con il resto dell'API WdbgExts.
RicaricareSymbols La funzione ReloadSymbols elimina le informazioni sui simboli dal debugger in modo che possa essere ricaricata in base alle esigenze. Questa funzione si comporta allo stesso modo del comando del debugger .reload.
SearchMemory La funzione SearchMemory cerca nella memoria virtuale della destinazione un modello di byte specificato.
SetThreadForOperation La funzione SetThreadForOperation imposta il thread da usare per la chiamata successiva di StackTrace.
SetThreadForOperation64 La funzione SetThreadForOperation64 imposta il thread da usare per la chiamata successiva di StackTrace.
TranslateVirtualToPhysical La funzione TranslateVirtualToPhysical converte un indirizzo di memoria virtuale in un indirizzo di memoria fisica.
WriteControlSpace La funzione WriteControlSpace scrive nello spazio di controllo specifico del processore della destinazione corrente.
WriteIoSpace La funzione WriteIoSpace scrive nei percorsi di I/O di sistema.
WriteIoSpace64 La funzione WriteIoSpace64 scrive nei percorsi di I/O di sistema.
WriteIoSpaceEx La funzione WriteIoSpaceEx è una versione estesa di WriteIoSpace.
WriteIoSpaceEx64 La funzione WriteIoSpaceEx64 è una versione estesa di WriteIoSpace64.
WriteMsr La funzione WriteMsr scrive in un Model-Specific Register (MSR).
WritePhysical La funzione WritePhysical scrive nella memoria fisica.
WritePhysicalWithFlags La funzione WritePhysicalWithFlags scrive nella memoria fisica.
WritePointer La funzione WritePointer scrive un puntatore alla destinazione.

Funzioni di callback

PSYM_DUMP_FIELD_CALLBACK La funzione di callback PSYM_DUMP_FIELD_CALLBACK viene chiamata dal motore del debugger durante l'operazione Ioctl IG_DUMP_SYMBOL_INFO con informazioni su un membro nel simbolo specificato.
PWINDBG_CHECK_CONTROL_C La funzione PWINDBG_CHECK_CONTROL_C (CheckControlC) verifica se l'utente ha premuto CTRL+C. Usare PWINDBG_CHECK_CONTROL_C in tutti i cicli per consentire all'utente di premere CTRL+C per terminare processi lunghi.
PWINDBG_CHECK_VERSION La funzione di callback PWINDBG_CHECK_VERSION (CheckVersion) verifica che la versione del modulo di estensione corrisponda alla versione del debugger e restituisce un messaggio di avviso se esiste una mancata corrispondenza.
PWINDBG_DISASM La funzione PWINDBG_DISASM (Disasm) disassembla l'istruzione puntata da lpOffset e inserisce la stringa stampabile in lpBuffer.
PWINDBG_EXTENSION_API_VERSION La funzione di callback di PWINDBG_EXTENSION_API_VERSION (ExtensionApiVersion) restituisce informazioni sulla versione della DLL dell'estensione.
PWINDBG_EXTENSION_DLL_INIT La funzione di callback PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) viene usata per caricare e inizializzare il modulo di estensione.
PWINDBG_GET_EXPRESSION La funzione PWINDBG_GET_EXPRESSION (GetExpression) restituisce il valore dell'espressione. L'espressione viene valutata usando l'analizzatore di espressioni corrente e può contenere alias.
PWINDBG_GET_SYMBOL La funzione PWINDBG_GET_SYMBOL (GetSymbol) individua il simbolo più vicino all'indirizzo.
PWINDBG_GET_THREAD_CONTEXT_ROUTINE La funzione PWINDBG_GET_THREAD_CONTEXT_ROUTINE (GetContext) implementa la funzionalità simile alla routine GetThreadContext di Microsoft Win32. Restituisce il contesto del processo sottoposto a debug.
PWINDBG_IOCTL_ROUTINE La funzione PWINDBG_IOCTL_ROUTINE (Ioctl) esegue diverse operazioni. Gran parte della sua funzionalità riflette la funzionalità di altre funzioni in wdbgexts.h.
PWINDBG_OUTPUT_ROUTINE La funzione di callback implementa la funzionalità per stampare una stringa formattata nella finestra Comando debugger.
PWINDBG_READ_PROCESS_MEMORY_ROUTINE La funzione PWINDBG_READ_PROCESS_MEMORY_ROUTINE (ReadMemory) funziona come la funzione ReadProcessMemory Win32. Legge la memoria dal processo in fase di debug. L'intera area da leggere deve essere accessibile o l'operazione non riesce.
PWINDBG_SET_THREAD_CONTEXT_ROUTINE La funzione PWINDBG_SET_THREAD_CONTEXT_ROUTINE (SetContext) è simile alla routine Win32 SetThreadContext. Imposta il contesto del processo in fase di debug.
PWINDBG_STACKTRACE_ROUTINE La funzione PWINDBG_STACKTRACE_ROUTINE (StackTrace) recupera una traccia dello stack per il processo in fase di debug. Restituisce il numero di fotogrammi letti nel buffer a cui punta stackframe.
PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE La funzione PWINDBG_WRITE_PROCESS_MEMORY_ROUTINE (WriteMemory) funziona come la routine WriteProcessMemory Win32. Scrive memoria nel processo in fase di debug. L'intera area da scrivere deve essere accessibile o l'operazione non riesce.

Strutture

BUSDATA L'operazione IG_GET_BUS_DATA Ioctl legge i dati da un bus di sistema e l'operazione Ioctl IG_SET_BUS_DATA scrive i dati in un bus di sistema.
DBGKD_GET_VERSION64 L'operazione IG_GET_KERNEL_VERSION Ioctl riceve informazioni correlate alla versione del sistema operativo della destinazione.
DEBUG_TYPED_DATA La struttura DEBUG_TYPED_DATA descrive i dati tipizzato nella memoria della destinazione.
EXT_TYPED_DATA La struttura EXT_TYPED_DATA viene passata a e restituita dall'operazione richiesta di DEBUG_REQUEST_EXT_TYPED_DATA_ANSI. Contiene i parametri di input e output per l'operazione e specificando quale specifica sottooperazione da eseguire.
FIELD_INFO La struttura FIELD_INFO viene usata dall'operazione di IG_DUMP_SYMBOL_INFOIoctl per fornire informazioni su un membro in una struttura.
POINTER_SEARCH_PHYSICAL L'operazione IG_POINTER_SEARCH_PHYSICAL Ioctl cerca la memoria fisica della destinazione per i puntatori che si trovano all'interno di un intervallo specificato.
READCONTROLSPACE Informazioni su come la funzione ReadControlSpace legge lo spazio di controllo specifico del processore nella matrice a cui punta buf.
READCONTROLSPACE64 Informazioni su come la funzione ReadControlSpace64 legge lo spazio di controllo specifico del processore nella matrice a cui punta buf.
SEARCHMEMORY Informazioni su come la funzione SearchMemory cerca la memoria virtuale della destinazione per un modello specificato di byte.
SYM_DUMP_PARAM L'operazione IG_DUMP_SYMBOL_INFO Ioctl fornisce informazioni sul tipo di un simbolo.
WDBGEXTS_THREAD_OS_INFO L'operazione IG_GET_THREAD_OS_INFO Ioctl restituisce informazioni su un thread del sistema operativo nella destinazione. Quando si chiama Ioctl con IoctlType impostato su IG_GET_THREAD_OS_INFO, IpvData deve contenere un'istanza della struttura WDBGEXTS_THREAD_OS_INFO.

Enumerazioni

EXT_TDOP L'enumerazione EXT_TDOP viene usata nel membro Operation della struttura EXT_TYPED_DATA per specificare quale sottooperazione verrà eseguita l'operazione richiesta DEBUG_REQUEST_EXT_TYPED_DATA_ANSI.