Método IDebugRegisters2::GetPseudoDescription (dbgeng.h)

El método GetPseudoDescription devuelve una descripción de un pseudo-register, incluido su nombre y tipo.

Sintaxis

HRESULT GetPseudoDescription(
  [in]            ULONG    Register,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

Parámetros

[in] Register

Especifica el índice del pseudo-register cuya descripción se solicita. El índice siempre está entre cero y el número de pseudoregistros (devueltos por GetNumberPseudoRegisters) menos uno.

[out, optional] NameBuffer

Recibe el nombre del pseudo-register. Si NameBuffer es null, no se devuelve esta información.

[in] NameBufferSize

Especifica el tamaño, en caracteres, del búfer que NameBuffer especifica. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] NameSize

Recibe el tamaño en caracteres del nombre del pseudo-register. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si NameSize es null, no se devuelve esta información.

[out, optional] TypeModule

Recibe la dirección base del módulo al que pertenece el tipo del registro. Si no se conoce el tipo del registro, se devuelve cero. Si TypeModule es NULL, no se devuelve información.

[out, optional] TypeId

Recibe el identificador de tipo del tipo del módulo devuelto en TypeModule. Si no se conoce el identificador de tipo, se devuelve cero. Si TypeId es NULL, no se devuelve información.

Valor devuelto

Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte valores HRESULT.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_FAIL	La descripción del registro no estaba disponible.

Observaciones

Las descripciones no siempre están disponibles para todos los registros. Si un pseudo-register no tiene un valor ( por ejemplo, $eventip no tendrá un valor antes de que se haya producido un evento o no se puede determinar un tipo para un pseudo-registro, este método devolverá E_FAIL.

Para obtener información general sobre la interfaz de IDebugRegisters y otros métodos relacionados con el registro, consulte Registers.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include DbgEng.h)

Consulte también

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2