Compartilhar via

PDEBUG_EXTENSION_PROVIDE_VALUE função de retorno de chamada (dbgeng.h)

  • Artigo

A função de retorno de chamada DebugExtensionProvideValue define valores de pseudo-registro .

 CALLBACK* PDEBUG_EXTENSION_PROVIDE_VALUE DebugExtensionProvideValue;

Sintaxe

PDEBUG_EXTENSION_PROVIDE_VALUE PdebugExtensionProvideValue;

HRESULT PdebugExtensionProvideValue(
  [in]  PDEBUG_CLIENT Client,
  [in]  ULONG Flags,
  [in]  PCWSTR Name,
  [out] PULONG64 Value,
  [out] PULONG64 TypeModBase,
  [out] PULONG TypeId,
  [out] PULONG TypeFlags
)
{...}

Parâmetros

[in] Client

Um cliente a ser usado se a extensão precisar de funções DbgEng.

[in] Flags

Fornece sinalizadores comportamentais. Esse parâmetro está reservado no momento.

[in] Name

O nome do valor a ser retornado. Esse nome pode ser um dos nomes que a função DebugExtensionQueryValueNames retornou ou um nome que o chamador já pode estar ciente.

[out] Value

Um ponteiro para o valor a ser definido.

[out] TypeModBase

O endereço inicial base do Cliente.

[out] TypeId

Um ponteiro para a ID para o tipo de Valor.

[out] TypeFlags

Um parâmetro que você pode usar para retornar um dos seguintes sinalizadores:

Valor Significado
DEBUG_EXT_PVTYPE_IS_VALUE
 O valor apontado por Value não é um ponteiro.
DEBUG_EXT_PVTYPE_IS_POINTER
 O valor apontado por Value é um endereço para um ponteiro para dados do tipo que TypeModBase e TypeId especificam.

Retornar valor

DebugExtensionProvideValue pode retornar um dos seguintes valores:

Código de retorno Descrição
S_OK
 A função foi concluída com êxito.
 

Essa função também pode retornar valores de erro. Para obter mais informações sobre possíveis valores retornados, consulte Valores retornados.

Comentários

O nome que o parâmetro Name especifica deve começar com $$ e ter um caractere NULL de terminação.

DebugExtensionProvideValue é chamado PDEBUG_EXTENSION_PROVIDE_VALUE no arquivo de cabeçalho Dbgeng.h.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h

Confira também

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionQueryValueNames

DebugExtensionUninitialize

KnownStructOutput