(dbgeng.h) 的 IDebugRegisters2：：GetPseudoDescription 方法

  • 發行項

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

語法

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

參數

[in] Register

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

[out, optional] NameBuffer

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

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] TypeModule

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

[out, optional] TypeId

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

傳回值

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

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

備註

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

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

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 DbgEng.h)

另請參閱

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2