SERCX2PIORECEIVE Object Handle
A SERCX2PIORECEIVE object handle is an opaque reference to a PIO-receive object in version 2 of the serial framework extension (SerCx2).
The SerCx2PioReceiveCreate method creates a PIO-receive object. SerCx2 uses object to manage programmed I/O (PIO) transactions that read data from the serial controller. This object is opaque to serial controller drivers. SerCx2PioReceiveCreate supplies, as an output parameter, a SERCX2PIORECEIVE handle to the newly created PIO-receive object. SerCx2 and the serial controller driver use this handle to refer to the object in subsequent PIO-receive transactions. For more information, see SerCx2 PIO-Receive Transactions.
After SerCx2PioReceiveCreate creates the PIO-receive object, this object exists for the lifetime of the framework device object that represents the serial controller device. The PIO-receive object is automatically deleted when the device object is deleted. The serial controller driver must not try to delete the PIO-receive object by calling a method such as WdfObjectDelete.
A serial controller driver must create one and only one PIO-receive object. The driver must create this object before creating either a system-DMA-receive object or a custom-receive object. For more information about system-DMA-receive objects, see SERCX2SYSTEMDMARECEIVE. For more information about custom-receive objects, see SERCX2CUSTOMRECEIVE.