共用方式為

IDebugRegisters2：：GetPseudoDescriptionWide 方法 （dbgeng.h）

  • 發行項

GetPseudoDescriptionWide 方法會傳回虛擬緩存器的描述，包括其名稱和類型。

語法

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

參數

[in] Register

指定要求其描述的虛擬緩存器索引。 索引一律介於零和虛擬緩存器數目之間（由 GetNumberPseudoRegisters傳回）減一。

[out, optional] NameBuffer

接收虛擬快取器的名稱。 如果 NameBufferNULL，則不會傳回此資訊。

[in] NameBufferSize

指定 NameBuffer 指定之緩衝區的大小，以字元為單位。 此大小包含 『\0』 終止字元的空間。

[out, optional] NameSize

接收虛擬快取器名稱的字元大小。 此大小包含 『\0』 終止字元的空間。 如果 NameSizeNULL，則不會傳回此資訊。

[out, optional] TypeModule

接收快取器類型所屬之模組的基位址。 如果未知快取器的類型，則會傳回零。 如果 typeModule NULL，則不會傳回任何資訊。

[out, optional] TypeId

在 TypeModule 中傳回的模組內接收型別的型別標識碼。 如果不知道類型識別碼，則會傳回零。 如果 TypeIdNULL，則不會傳回任何資訊。

傳回值

此清單不包含可能發生的所有錯誤。 如需可能的錯誤清單，請參閱 HRESULT 值。

傳回碼 描述
S_OK
 方法成功。
E_FAIL
 登錄的描述無法使用

言論

所有快取器不一定都能使用描述。 如果虛擬緩存器沒有值，例如，$eventip 在發生事件之前不會有值，或無法判斷虛擬緩存器的類型，這個方法會傳回E_FAIL。

如需 IDebugRegisters 介面和其他註冊相關方法的概觀，請參閱 Registers。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include DbgEng.h）

另請參閱

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2