dev_Unblock()

Reconnect any layers below the top layer which are not in data transfer state.

#include "device.h"

LResult  dev_Unblock
    (
         LDevice  device
    );

dev_Unblock() is intended to be used for devices in which the top layer is not multiplexed. In this type of device, data transfer takes place through the top protocol layer. If lgo_Read() or lgo_Write() returns lgo_ERROR_TRANSMISSION_BLOCKED when one or more layers below in a device are not in data transfer state. dev_Unblock() can be called in this case to try to fix the device.

If successful, dev_Unblock() returns a non-negative value representing the number of bytes written. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dev_ERROR_INVALID_DEVICE
• dev_ERROR_DEVICE_NOT_OPEN
• dev_ERROR_DEVICE_NOT_CONNECTED
• dev_ERROR_DEVICE_NOT_BLOCKED
• dev_ERROR_TEMPORARY_BLOCK

dev_Check()
dev_Fix()

if ((result = lgo_Write(cid, buffer, count)) < 0)
{
    if (result == lgo_ERROR_TRANSMISSION_BLOCKED)
    {
        if ((result = dev_Unblock(majorDevice) < 0)
        {
            LOG("Unblock failure", dev_ErrorMessage(result));
        }
    }
}