IeXdiServer::ReadPhysicalMemoryOrPeriphIO
This method reads a block of data from physical memory or a peripheral I/O.
HRESULT ReadPhysicalMemoryOrPeriphIO(
ADDRESS_TYPE Address,
BYTE bAddressSpace,
DWORD dwNbElemToRead,
BYTE bAccessWidth,
BYTE* pbReadBuffer
);
Parameters
- Address
[in] Starting address of the data buffer to be accessed on the target. - bAddressSpace
[in] Address space to be accessed. Specify 0 for physical memory or 1 for peripheral I/O, if not mapped to memory. You can specify values between 2 and 255 for custom use. - dwNbElemToRead
[in] Number of elements to be accessed. Each element contains a number of bits defined by the value of the bAccessWidth parameter. - bAccessWidth
[in] Data width in bits. Specify 8 for byte, 16 for WORD, 32 for DWORD, 64 for DDWORD, or any other value supported by the target. - pbReadBuffer
[out] Buffer to which the method writes data that is read. The size of the buffer is defined by the expressionsize_is(dwNbElemToRead * (((bAccessWidth - 1) >> 3) + 1)). The buffer must be large enough to contain all elements returned. You must align elements on a byte boundary. You must add bit padding if the value of the bAccessWidth parameter is not multiple of 8. Microsoft recommends that the server be able to handle buffers that are at least 64 KB.
Return Values
This method has the following return values.
| Return value | Description |
|---|---|
| S_OK | Function is successful. |
| EXDI_E_NOTIMPL | Not implemented. |
| EXDI_E_OUTOFMEMORY | Failed to allocate necessary memory. |
| EXDI_E_ABORT | Operation aborted. |
| EXDI_E_FAIL | Unspecified failure occurred. |
| EXDI_E_COMMUNICATION | Communication error occurred between host driver and target. |
| EXDI_E_INVALIDARG | One or more arguments are invalid. |
| EXDI_E_CANNOTWHILETGTRUNNING | Cannot proceed while target is running. |
| EXDI_E_USEDBYCONCURRENTTHREAD | Cannot proceed immediately because resource is already used by concurrent thread. |
Requirements
OS Versions: Windows CE 3.0 and later.
Header: exdi.idl.
See Also
Last updated on Friday, October 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.