IDebugDataSpaces：：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 位元組中，從位 移位置開始。
PatternGranularity 可用來確保比對相對於 Offset 的對齊方式。 例如，可以使用 0x4 的值來要求對齊 DWORD。 0x1值可用來允許模式在任何位置啟動。
如需其他選項，包括將搜尋限制為可寫入記憶體的功能，請參閱 SearchVirtual2。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | dbgeng.h (包含 Dbgeng.h) |