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

Artigo
02/06/2025

O DebugExtensionProvideValue conjuntos de funções de retorno de chamada 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. Este 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 do tipo Value.

[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.

Valor de retorno

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.

Observações

O nome especificado pelo parâmetro Name deve começar com $$ e ter um caractere NULL de encerramento.

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h

Consulte também

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionQueryValueNames

DebugExtensionUninitialize

KnownStructOutput

Compartilhar via