IOsAxsMem::SearchMemoryByProc (Windows Embedded CE 6.0)

1/5/2010

This method searches memory for a block that matches a given sequence.

Syntax

HRESULT SearchMemoryByProc(
  [in] DWORD ProcID,
  [in] LINEAR_MEM_MAP_TYPE lmt,
  [in] ADDRESS_TYPE AddressRangeStart,
  [in] ADDRESS_TYPE AddressRangeEnd,
  [in] DWORD dwNbElem,
  [in] BYTE bAccessWidthInBytes,
  [in, size_is(dwNbElem* bAccessWidthInBytes)] BYTE* pbSequenceToSearch 
  [out] ADDRESS_TYPE** ppAddressFound
);

Parameters

• ProcID
  Identifier of the process of interest.

• lmt
  Linear memory map type.

  The following memory map types are used by convention:

  Value	Description
  LMM_VIRT, 0	Virtual memory
  LMM_PHYS, 1	Physical memory
  LMM_IO, 2	Peripheral I/O
  3 and higher	Free for custom use

• AddressRangeStart
  Starting address of the memory block to be searched on the target device.

• AddressRangeEnd
  Ending address (included) of the memory block to be searched on the target device.

• dwNbElem
  Number of elements of bAccessWidthInBytes bytes to be searched in size of pbSequenceToSearch.

• bAccessWidthInBytes
  Data width in bytes, where byte=1, word=2, dword=4, and so on.

• pbSequenceToSearch
  Buffer containing the sequence to search.

  This value must be at least as large as dwNbElem.

  Note

  The server should handle sequence buffers of at least 1 KB.

• ppAddressFound
  Pointer to the first occurrence of the address that includes pbSequenceToSearch. If not found, returns a NULL pointer.

  The buffer for this value is allocated by CoTaskMemAlloc.

Return Value

The following table shows return values for this method.

Remarks

To avoid resource leaking, use CoTaskMemFree to free the task memory used by the buffer for ppAddressFound.

In general, the driver internal mechanism should be transparent to the client.

Requirements

See Also

Reference

IOsAxsMem
IOsAxs Interfaces