IeXdi2Mem::GetMemAccessExclusionRange (Windows CE 5.0)
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.
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 Values
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
OS Version: Windows CE 5.0 and later.
Header: eXDI2.h.
Link Library: ole32.lib oleaut32.lib.
See Also
Send Feedback on this topic to the authors