IeXdi2Mem::GetMemAccessExclusionRange (Windows Embedded CE 6.0)

1/5/2010

This method retrieves the list of memory access exclusion ranges. This list is used to filter access on the memory range.

This method is useful to accommodate hardware that does not recover from invalid memory access.

Syntax

HRESULT GetMemAccessExclusionRange(
  [in] LINEAR_MEM_MAP_TYPE lmt,
  [out] DWORD* pdwNbTotalExclRange,
  [out, size_is(,*pdwNbTotalExclRange)] MEM_ACCESS_EXCLUSION_RANGE** ppmaerExclusionList
);

Parameters

• 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

• pdwNbTotalExclRange
  Total number of exclusion range elements to be provided in ppmaerExclusionList.

• ppmaerExclusionList
  Pointer to the table of MEM_ACCESS_EXCLUSION_RANGE elements that associate an address range with an access restriction.

  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 the MEM_ACCESS_EXCLUSION_RANGE table that this function points to with ppmaerExclusionList.

Requirements

See Also

Reference

IeXdi2Mem
IeXDI2 Interfaces