Metodo IDebugDataSpaces::SearchVirtual (dbgeng.h)

Articolo
02/06/2025

Il metodo SearchVirtual cerca nella memoria virtuale della destinazione un criterio di byte specificato.

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 di ricerca del criterio. Una corrispondenza con esito positivo richiede che l'intero modello venga trovato prima di esaminare lunghezza byte.

[in] Pattern

Specifica il modello da cercare.

[in] PatternSize

Specifica le dimensioni in byte del criterio. Deve trattarsi di un multiplo della granularità del modello.

[in] PatternGranularity

Specifica la granularità del modello. Per una corrispondenza corretta, il criterio 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
HRESULT_FROM_NT(STATUS_NO_MORE_ENTRIES)	Dopo aver esaminato lunghezza byte il criterio non è stato trovato.

Osservazioni

Questo metodo cerca la prima occorrenza della memoria virtuale della destinazione, soggetta alla granularità, del modello interamente contenuto nel Lunghezza byte della memoria della destinazione a partire dalla posizione Offset.

PatternGranularity può essere usato per garantire l'allineamento della corrispondenza rispetto all'offset . Ad esempio, un valore di 0x4 può essere usato per richiedere l'allineamento a una DWORD. È possibile usare un valore di 0x1 per consentire l'avvio del modello in qualsiasi punto.

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