다음을 통해 공유


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

GetValues 메서드는 대상의 여러 레지스터값을 가져옵니다.

통사론

HRESULT GetValues(
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [out]          PDEBUG_VALUE Values
);

매개 변수

[in] Count

값이 요청된 레지스터 수를 지정합니다.

[in, optional] Indices

값을 가져올 레지스터의 인덱스를 포함하는 배열을 지정합니다. 이 배열의 요소 수는 count . 인덱스 NULL 경우 시작 대신 사용됩니다.

[in] Start

인덱스 NULL 경우 레지스터는 이 인덱스에서 시작하여 연속적으로 읽습니다. 그렇지 않으면 무시됩니다.

[out] Values

레지스터의 값을 받습니다. 이 배열이 보유하는 요소 수는 count . 이 매개 변수 형식에 대한 설명은 DEBUG_VALUE 참조하세요.

반환 값

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

반환 코드 묘사
S_OK
메서드가 성공했습니다.
E_UNEXPECTED
대상에 액세스할 수 없거나 레지스터 중 하나에 액세스할 수 없습니다.
E_INVALIDARG
레지스터 중 하나의 인덱스 값이 대상 컴퓨터의 레지스터 수보다 큽니다. 부분 결과를 얻었을 수 있습니다. 읽을 수 없는 레지스터에는 DEBUG_VALUE_INVALID 형식이 있습니다.

발언

GetValues 대상 레지스터의 여러 값을 가져옵니다.

반환 값이 S_OK 않으면 일부 레지스터가 여전히 읽혀졌을 수 있습니다. 대상에 액세스할 수 없는 경우 반환 형식이 E_UNEXPECTED 변경되지 않습니다. 그렇지 않으면 부분 결과가 포함되고 읽을 수 없는 레지스터에는 DEBUG_VALUE_INVALID 형식이 포함됩니다. 이 메서드를 호출하기 전에 메모리를 0으로 설정하여 반환 값 E_UNEXPECTED 경우 모호성을 방지할 수 있습니다.

단일 레지스터의 값만 받으려면 대신 GetValue 메서드를 사용합니다.

GetValues2 메서드는 이 메서드와 동일한 작업을 수행하지만 레지스터 원본을 지정할 수도 있습니다.

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

요구 사항

요구
대상 플랫폼 바탕 화면
헤더 dbgeng.h(DbgEng.h 포함)

참고 항목

GetValue

GetValues2

IDebugRegisters

IDebugRegisters2