IDebugDataSpaces::ReadVirtual 메서드(dbgeng.h)

ReadVirtual 메서드는 대상의 가상 주소 공간에서 메모리를 읽습니다.

구문

HRESULT ReadVirtual(
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

매개 변수

[in] Offset

읽을 대상의 가상 주소 공간에 있는 위치를 지정합니다.

[out] Buffer

메모리를 읽을 버퍼를 지정합니다.

[in] BufferSize

버퍼의 크기(바이트)를 지정합니다. 요청되는 바이트 수이기도 합니다.

[out, optional] BytesRead

읽은 바이트 수를 받습니다. NULL로 설정하면 이 정보가 반환되지 않습니다.

반환 값

반환 코드 Description
S_OK
메서드를 성공적으로 수행했습니다. BytesReadBufferSize보다 작지만 하나 이상의 데이터가 반환되었을 수 있습니다.
 

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

설명

이 메서드는 대상의 가상 주소 공간에 있는 메모리의 내용으로 버퍼를 채웁니다.

이 메서드는 데이터를 검색할 때 메모리 데이터의 캐시를 참조할 수 있습니다. 메모리 매핑 하드웨어 상태와 같이 데이터가 휘발성이면 ReadVirtualUncached 를 대신 사용합니다.

포인터가 포함된 메모리를 읽을 때 이러한 포인터는 엔진이 아닌 대상의 가상 주소 공간에 대한 것입니다. 예를 들어 데이터 구조에 문자열이 포함된 경우 문자열의 내용을 읽으려면 이 메서드에 대한 두 번째 호출이 필요할 수 있습니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 dbgeng.h(Dbgeng.h 포함)

추가 정보

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtualUncached

WriteVirtual