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

Artículo
02/23/2024

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

Sintaxis

HRESULT GetPseudoDescriptionWide(
  [in]            ULONG    Register,
  [out, optional] PWSTR    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, esta información no se devuelve.

[in] NameBufferSize

Especifica el tamaño, en caracteres, del búfer que especifica NameBuffer . 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, esta información no se devuelve.

[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 dentro 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	Método realizado correctamente.
E_FAIL	La descripción del registro no estaba disponible

Comentarios

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 pueda determinar un tipo para un pseudo-register, este método devolverá E_FAIL.

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