IDebugDataSpaces3::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

パターンを検索する距離を指定します。 一致が成功した場合、Length バイトが調べられる前に、パターン全体が見つかる必要があります。

[in] Pattern

検索するパターンを指定します。

[in] PatternSize

パターンのサイズをバイト単位で指定します。 これは、パターンの粒度の倍数である必要があります。

[in] PatternGranularity

パターンの粒度を指定します。 一致を成功させるには、開始位置の後にこの値の倍数がパターンで発生する必要があります。

[out] MatchOffset

パターンが見つかった場合は、ターゲットの仮想アドレス空間内の場所を受け取ります。

戻り値

このメソッドは、エラー値を返すこともできます。 詳細については 戻り値の を参照してください。

注釈

このメソッドは、ターゲットの仮想メモリを検索して、位置 Offset から始まるターゲットのメモリの Length バイトに完全に含まれるパターンの最初の出現を、粒度に従って検索 します。

PatternGranularity を使用して、オフセットに対する一致の配置を保証できます。 たとえば、0x4の値を使用して、DWORD へのアラインメントを要求できます。 0x1の値を使用して、任意の場所でパターンを開始できます。

検索を書き込み可能なメモリに制限する機能など、追加のオプションについては、 SearchVirtual2 を参照してください。

必要条件

こちらもご覧ください

IDebugDataSpaces の

IDebugDataSpaces2 の

IDebugDataSpaces3 を する

IDebugDataSpaces4

ReadVirtual の

SearchVirtual2