Método IDebugDataSpaces2::SearchVirtual (dbgeng.h)
El método SearchVirtual busca en la memoria virtual del destino un patrón de bytes especificado.
Sintaxis
HRESULT SearchVirtual(
[in] ULONG64 Offset,
[in] ULONG64 Length,
[in] PVOID Pattern,
[in] ULONG PatternSize,
[in] ULONG PatternGranularity,
[out] PULONG64 MatchOffset
);
Parámetros
[in] Offset
Especifica la ubicación en el espacio de direcciones virtuales del destino para empezar a buscar el patrón.
[in] Length
Especifica cuánto se va a buscar el patrón. Una coincidencia correcta requiere que se encuentre todo el patrón antes de que se hayan examinado bytes de longitud.
[in] Pattern
Especifica el patrón que se va a buscar.
[in] PatternSize
Especifica el tamaño en bytes del patrón. Debe ser un múltiplo de la granularidad del patrón.
[in] PatternGranularity
Especifica la granularidad del patrón. Para una coincidencia correcta, el patrón debe producirse un múltiplo de este valor después de la ubicación de inicio.
[out] MatchOffset
Recibe la ubicación del espacio de direcciones virtuales del patrón en el destino, si se encontró.
Valor devuelto
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
Después de examinar Longitud bytes, no se encontró el patrón. |
Observaciones
Este método busca en la memoria virtual del destino la primera aparición, sujeta a granularidad, del patrón incluido completamente en el Length bytes de la memoria del destino a partir de la ubicación Offset.
patrónGranularidad se puede usar para garantizar la alineación de la coincidencia con respecto a Desplazamiento. Por ejemplo, se puede usar un valor de 0x4 para requerir la alineación con un DWORD. Se puede usar un valor de 0x1 para permitir que el patrón se inicie en cualquier lugar.
Para obtener más opciones, incluida la capacidad de restringir la búsqueda a memoria grabable, consulte SearchVirtual2.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |