Metodo IDebugControl::GetWindbgExtensionApis64 (dbgeng.h)
Il metodo GetWindbgExtensionApis64 restituisce una struttura che facilita l'uso dell'API WdbgExts.
Sintassi
HRESULT GetWindbgExtensionApis64(
[in, out] PWINDBG_EXTENSION_APIS64 Api
);
Parametri
[in, out] Api
Riceve una struttura WINDBG_EXTENSION_APIS64. Questa struttura contiene le funzioni usate dall'API WdbgExts. Il membro nSize di questa struttura deve essere impostato sulla dimensione della struttura prima che venga passata a questo metodo.
Valore restituito
Questo metodo può anche restituire altri valori di errore. Per altre informazioni, vedere Valori restituiti .
Codice restituito | Descrizione |
---|---|
|
Il metodo è stato eseguito correttamente. |
|
Il valore di Api->nSize non equivale alla dimensione della struttura WINDBG_EXTENSION_APIS64. |
Commenti
Se si include Wdbgexts.h nel codice di estensione, è necessario chiamare questo metodo durante l'inizializzazione della DLL dell'estensione (vedere DebugExtensionInitialize).
Molte funzioni WdbgExts sono davvero macro. Per assicurarsi che queste macro funzionino correttamente, la struttura ricevuta dal parametro Api deve essere archiviata in una variabile globale denominata ExtensionApis.
La struttura WINDBG_EXTENSION_APIS64 restituita da questo metodo serve lo stesso scopo fornito alla funzione di callback WinDbgExtensionDllInit (utilizzata dalle estensioni WdbgExts).
Per un elenco delle funzioni fornite dall'API WdbgExts, vedere Funzioni WdbgExts.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h) |