NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <ddm/ddm.h>KnError svDdmShutdown(DevNode node);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
DDM
The svDdmShutdown() call enables the DDM client to request that the driver running on the specified node is shutdown. In this situation, the availability state of the device is initially set to DDM_AVSTATE_DISABLED. This inhibits any drivers from being started for the device.
The svDdmShutdown()state change request is a complex operation. This is because it generally involves the propagation of an event from the driver to all its child drivers, and its clients. A device can only be shutdown once the client(s) of the device stop using it and close their connection to it. Only once this is done will the device be shutdown.
The DDM client should poll the state of the device (by calls to svDdmGetState(2K)) to check that the device has successfully changed its run state to DDM_RUNSTATE_INACTIVE.
Upon completion K_OK is returned provided the device was successfully shutdown. Otherwise, a negative error code is returned which indicates why the call was not successful.
The specified node is not recognized as a manageable device
The node driver does not implement dynamic shutdown. It is not capable of accepting a dynamic shutdown request. It is not supported by the driver.
The system is out of resources. This indicates a severe system error.
The device tree is corrupted and the PROP_DRIVER of the node was not able to be identified, or the operation failed.
The child_shutdown routine is applied to a driver which has no parent driver
See mngt.9ddi for further details.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
svDdmOpen(2K), svDdmClose(2K), svDdmGetState(2K), , svDdmEnable(2K), svDdmDisable(2K), svDdmOffline(2K), svDdmOnline(2K), svDdmGetStats(2K), svDdmAudit(2K), svDdmDiag(2K), svDdmGetInfo(2K), DDM(5FEA), mngt(9DDI)
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO