IeXdiServer::WritePhysicalMemoryOrPeriphIO

This method writes a block of data to physical memory or a peripheral I/O.

HRESULT WritePhysicalMemoryOrPeriphIO(
  ADDRESS_TYPE Address,
  BYTE bAddressSpace,
  DWORD dwNbElemToWrite,
  BYTE bAccessWidth,
  const BYTE* pbWriteBuffer
);

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.
  • dwNbElemToWrite
    [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.
  • pbWriteBuffer
    [in] Buffer containing the data to be written. The size of the buffer is defined by the expression size_is(dwNbElemToRead * (((bAccessWidth - 1) >> 3) + 1)). The buffer must be large enough to contain all elements to be written. 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

IeXdiServer

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.