The SerCxRetrieveReceiveMdl method retrieves the MDL that describes the buffer to use to receive the next block of input data.
- 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.
SerCxRetrieveReceiveMdl 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 receive (read) operation. The MDL describes the buffer memory into which the driver is to transfer the received data. The driver is the exclusive owner of this MDL until it calls the SerCxProgressReceive 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.|