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).
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.