IDebugRegisters2::GetPseudoDescription 메서드(dbgeng.h)

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

설명이 요청된 의사 레지스터의 인덱스를 지정합니다. 인덱스는 항상 0과 의사 레지스터 수( GetNumberPseudoRegisters에서 반환됨)에서 1을 뺀 값 사이입니다.

[out, optional] NameBuffer

의사 레지스터의 이름을 받습니다. NameBuffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] NameBufferSize

NameBuffer에서 지정하는 버퍼의 크기를 문자 단위로 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] NameSize

의사 레지스터 이름의 문자로 크기를 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. NameSize가 NULL이면 이 정보가 반환되지 않습니다.

[out, optional] TypeModule

레지스터의 형식이 속한 모듈의 기본 주소를 받습니다. 레지스터의 형식을 알 수 없는 경우 0이 반환됩니다. TypeModule이 NULL이면 정보가 반환되지 않습니다.

[out, optional] TypeId

TypeModule에서 반환된 모듈 내에서 형식의 형식 ID를 받습니다. 형식 ID를 알 수 없는 경우 0이 반환됩니다. TypeId가 NULL이면 정보가 반환되지 않습니다.

반환 값

이 목록에 발생할 수 있는 모든 오류가 포함되어 있지는 않습니다. 가능한 오류 목록은 HRESULT 값을 참조하세요.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	레지스터에 대한 설명을 사용할 수 없습니다.

설명

설명은 모든 레지스터에 항상 사용할 수 있는 것은 아닙니다. 의사 레지스터에 값이 없는 경우(예: $eventip 이벤트가 발생하기 전에 값이 없거나 의사 레지스터에 대해 형식을 확인할 수 없는 경우 이 메서드는 E_FAIL 반환합니다.

IDebugRegisters 인터페이스 및 기타 레지스터 관련 메서드에 대한 개요는 레지스터를 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	dbgeng.h(DbgEng.h 포함)

추가 정보

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2