IDebugDataSpaces4::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
パターンのターゲットの仮想アドレス空間内の場所が見つかった場合は、それを受け取ります。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
Length バイトを調べた後、パターンが見つかりませんでした。 |
注釈
このメソッドは、ターゲットのメモリの Length バイトに完全に含まれるパターンの最初の出現箇所 (粒度に応じて) を検索します。これは、位置 Offset から始まるターゲットのメモリの Length バイトです。
PatternGranularity を使用すると、 Offset に対する一致を確実に調整できます。 たとえば、0x4 の値を使用して、DWORD へのアラインメントを要求できます。 0x1の値を使用すると、パターンをどこからでも開始できます。
検索を書き込み可能なメモリに制限する機能など、追加のオプションについては、「 SearchVirtual2」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |