SERCX2SYSTEMDMARECEIVE Object Handle

A SERCX2SYSTEMDMARECEIVE object handle is an opaque reference to a system-DMA-receive object in version 2 of the serial framework extension (SerCx2).

Remarks

The SerCx2SystemDmaReceiveCreate method creates a system-DMA-receive object. SerCx2 uses this object to manage system DMA transactions that read data from the serial controller. This object is opaque to serial controller drivers. SerCx2SystemDmaReceiveCreate supplies, as an output parameter, a SERCX2SYSTEMDMARECEIVE handle to the newly created system-DMA-receive object. SerCx2 and the serial controller driver use this handle to refer to the object in subsequent system-DMA-receive transactions. For more information, see SerCx2 System-DMA-Receive Transactions.

After SerCx2SystemDmaReceiveCreate creates the system-DMA-receive object, this object exists for the lifetime of the framework device object that represents the serial controller device. The system-DMA-receive object is automatically deleted when the device object is deleted. The serial controller driver must not try to delete the system-DMA-receive object by calling a method such as WdfObjectDelete.

A serial controller driver can, as an option, create a system-DMA-receive object, but can create no more than one such object. The driver can create this object only under the following conditions:

  • The driver previously created a PIO-receive object.
  • The driver has not created a custom-receive object.

For more information about PIO-receive objects, see SERCX2PIORECEIVE. For more information about custom-receive objects, see SERCX2CUSTOMRECEIVE.

Requirements

Header

2.0\Sercx.h

See also

SerCx2SystemDmaReceiveCreate
WdfObjectDelete

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft