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
指定搜尋模式的距離。 成功比對需要找到整個模式,才能檢查 長度 位元組。
[in] Pattern
指定要搜尋的模式。
[in] PatternSize
以位元組為單位指定模式的大小。 這必須是模式的多個粒度。
[in] PatternGranularity
指定模式的數據粒度。 若要成功比對,模式必須在開始位置之後發生這個值的倍數。
[out] MatchOffset
如果找到該模式,則會接收目標虛擬位址空間中的位置。
傳回值
這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
檢查 長度 位元組之後,找不到模式。 |
言論
這個方法會搜尋目標虛擬記憶體中第一次出現,並受限於數據粒度,該模式完全包含在目標記憶體的 長度 位元組,從位置開始 Offset。
PatternGranularity 可用來確保比對相對於 Offset的對齊方式。 例如,0x4的值可用來要求對齊 DWORD。 0x1的值可用來允許模式在任何地方啟動。
如需其他選項,包括將搜尋限制為可寫入記憶體的功能,請參閱 SearchVirtual2。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |