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.
| Value | Description |
|---|---|
S_OK |
Indicates the function was successful. |
E_FAIL |
Indicates an unspecified failure. |
E_NOTIMPL |
Indicates the memory map is not implemented. |
EXDI_E_COMMUNICATION |
Indicates a communication error between host driver and debugging target. |
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
| Header | eXDI2.h |
| Library | ole32.lib, oleaut32.lib |
| Windows Embedded CE | Windows CE 5.0 and later |