Metodo IDebugDataSpaces3::SearchVirtual (dbgeng.h)

Articolo
02/23/2024

Il metodo SearchVirtual cerca la memoria virtuale della destinazione per un modello specificato di byte.

Sintassi

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

Parametri

[in] Offset

Specifica la posizione nello spazio indirizzi virtuale della destinazione per iniziare a cercare il modello.

[in] Length

Specifica la distanza da cercare per il modello. Una corrispondenza con esito positivo richiede che l'intero modello venga trovato prima dell'esame dei byte di lunghezza .

[in] Pattern

Specifica il modello da cercare.

[in] PatternSize

Specifica le dimensioni in byte del modello. Questo deve essere un multiplo della granularità del modello.

[in] PatternGranularity

Specifica la granularità del modello. Per una corrispondenza riuscita, il modello deve verificarsi un multiplo di questo valore dopo la posizione iniziale.

[out] MatchOffset

Riceve la posizione nello spazio indirizzi virtuale della destinazione del modello, se è stato trovato.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Dopo aver esaminato i byte di lunghezza , il modello non è stato trovato.

Commenti

Questo metodo cerca la memoria virtuale della destinazione per la prima occorrenza, soggetta a granularità, del modello interamente contenuto nei byte di lunghezza della memoria della destinazione a partire dall'offset del percorso.

PatternGranularity può essere usato per garantire l'allineamento della corrispondenza rispetto a Offset. Ad esempio, un valore di 0x4 può essere usato per richiedere l'allineamento a una DWORD. Un valore di 0x1 può essere usato per consentire all'avvio del modello ovunque.

Per altre opzioni, inclusa la possibilità di limitare la ricerca alla memoria scrivibile, vedere SearchVirtual2.