PSYM_DUMP_FIELD_CALLBACK função de retorno de chamada (wdbgexts.h)

Artigo
02/29/2024

A função de retorno de chamada PSYM_DUMP_FIELD_CALLBACK é chamada pelo mecanismo de depurador durante a operação ioctl IG_DUMP_SYMBOL_INFO com informações sobre um membro no símbolo especificado.

Sintaxe

PSYM_DUMP_FIELD_CALLBACK PsymDumpFieldCallback;

ULONG PsymDumpFieldCallback(
  _FIELD_INFO *pField,
  PVOID UserContext
)
{...}

Parâmetros

pField

Especifica o campo para o qual essa função de retorno de chamada está sendo chamada. O mecanismo de depurador preenche o conteúdo desse parâmetro antes de fazer a chamada. Consulte FIELD_INFO para obter detalhes sobre os membros desse parâmetro.

UserContext

Especifica o objeto de contexto do usuário passado para a operação Ioctl no membro Context da estrutura SYM_DUMP_PARAM.

Retornar valor

Se a função for bem-sucedida, ela deverá retornar STATUS_SUCCESS. Caso contrário, ele deverá retornar um código de erro apropriado.

Comentários

Se você estiver escrevendo uma extensão WdbgExts, inclua wdbgexts.h. Se você estiver escrevendo uma extensão DbgEng que usa esse protótipo de função, inclua wdbgexts.h antes de dbgeng.h (consulte Escrevendo código de extensão DbgEng para obter detalhes). STATUS_SUCCESS e outros códigos de erro e status são definidos em ntstatus.h.