The SerCxRetrieveTransmitMdl method retrieves the MDL that describes the buffer that contains the next block of output data to be transmitted.
- Device [in]
A WDFDEVICE handle to the framework device object that represents the serial controller.
- Mdl [out]
A pointer to a location into which the method writes a pointer to the MDL.
SerCxRetrieveTransmitMdl returns STATUS_SUCCESS if the call is successful. Possible return values include the following error codes.
This value is returned if one of the following occurs:
The serial controller driver calls this function to obtain an MDL to use for the current transmit (write) operation. The MDL describes the buffer memory from which the driver is to obtain the data to be transmitted. The driver is the exclusive owner of this MDL until it calls the SerCxProgressTransmit method, after which the MDL pointer is invalid and the driver must no longer try to access either the MDL or the buffer memory that the MDL describes.
For more information about MDLs, see Using MDLs.
|Available starting with Windows 8.|