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

GetDescription 메서드는 레지스터에 대한 설명을 반환합니다.

구문

HRESULT GetDescription(
  [in]            ULONG                       Register,
  [out, optional] PSTR                        NameBuffer,
  [in]            ULONG                       NameBufferSize,
  [out, optional] PULONG                      NameSize,
  [out, optional] PDEBUG_REGISTER_DESCRIPTION Desc
);

매개 변수

[in] Register

설명이 요청되는 레지스터의 인덱스를 지정합니다.

[out, optional] NameBuffer

레지스터의 이름을 저장할 버퍼를 지정합니다. NameBuffer가 NULL이면 이 정보가 반환되지 않습니다.

[in] NameBufferSize

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

[out, optional] NameSize

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

[out, optional] Desc

레지스터에 대한 설명을 받습니다. 자세한 내용은 DEBUG_REGISTER_DESCRIPTION 참조하세요.

반환 값

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

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 버퍼가 레지스터의 이름을 보유할 만큼 크지 않아 잘렸습니다.
E_UNEXPECTED	대상 컴퓨터를 지정하지 않았거나 레지스터에 대한 설명을 찾을 수 없습니다.
E_INVALIDARG	요청된 레지스터의 인덱스가 대상 컴퓨터의 총 레지스터 수보다 큽니다.

설명

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

요구 사항

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