IDebugDataSpaces2::SearchVirtual 메서드(dbgeng.h)

SearchVirtual 메서드는 대상의 가상 메모리에서 지정된 바이트 패턴을 검색합니다.

구문

HRESULT SearchVirtual(
  [in]  ULONG64  Offset,
  [in]  ULONG64  Length,
  [in]  PVOID    Pattern,
  [in]  ULONG    PatternSize,
  [in]  ULONG    PatternGranularity,
  [out] PULONG64 MatchOffset
);

매개 변수

[in] Offset

패턴 검색을 시작할 대상의 가상 주소 공간에 있는 위치를 지정합니다.

[in] Length

패턴을 검색할 간격을 지정합니다. 일치가 성공하려면 길이 바이트를 검사하기 전에 전체 패턴을 찾어야 합니다.

[in] Pattern

검색할 패턴을 지정합니다.

[in] PatternSize

패턴의 크기(바이트)를 지정합니다. 이는 패턴의 세분성의 배수여야 합니다.

[in] PatternGranularity

패턴의 세분성을 지정합니다. 일치가 성공하려면 패턴이 시작 위치 다음에 이 값의 배수로 발생해야 합니다.

[out] MatchOffset

패턴이 발견된 경우 대상의 가상 주소 공간에서 위치를 받습니다.

반환 값

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

반환 코드 Description
S_OK
메서드를 성공적으로 수행했습니다.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)
길이 바이트를 검사한 후 패턴을 찾을 수 없습니다.

설명

이 메서드는 대상의 가상 메모리에서 위치 오프셋부터 시작하여 대상 메모리의 Length 바이트에 완전히 포함된 패턴의 세분성에 따라 첫 번째 발생을 검색합니다.

PatternGranularity 를 사용하여 오프셋을 기준으로 일치 항목의 맞춤을 확인할 수 있습니다. 예를 들어 0x4 값을 사용하여 DWORD에 맞게 정렬할 수 있습니다. 0x1 값을 사용하여 패턴이 어디서나 시작되도록 할 수 있습니다.

쓰기 가능한 메모리로 검색을 제한하는 기능을 비롯한 추가 옵션은 SearchVirtual2를 참조하세요.

요구 사항

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

추가 정보

IDebugDataSpaces

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

ReadVirtual

SearchVirtual2