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 |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
레지스터에 대한 설명을 사용할 수 없습니다. |
설명
설명은 모든 레지스터에 항상 사용할 수 있는 것은 아닙니다. 의사 레지스터에 값이 없는 경우(예: $eventip 이벤트가 발생하기 전에 값이 없거나 의사 레지스터에 대해 형식을 확인할 수 없는 경우 이 메서드는 E_FAIL 반환합니다.
IDebugRegisters 인터페이스 및 기타 레지스터 관련 메서드에 대한 개요는 레지스터를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | dbgeng.h(DbgEng.h 포함) |