device_set_status

Function - Set device status.

SYNOPSIS

#include< device/device.h>

kern_return_t   device_set_status
                (mach_port_t                             device,
                 dev_flavor_t                            flavor,
                 dev_status_t                            status,
                 mach_msg_type_number_t            status_count);

PARAMETERS

device

[in device send right] A device port to the device to be manipulated.

flavor

[in scalar] The type of status information to set.

status

[pointer to in array of natural-sized units] The status information to set.

status_count

[in scalar] The size of the status information (in natural-sized units).

DESCRIPTION

The device_set_status function sets device status. The possible values of flavor as well as the corresponding meanings are device dependent.

RETURN VALUES

D_DEVICE_DOWN

Device has been shut down

D_IO_ERROR

Hardware I/O error

D_NO_SUCH_DEVICE

No device with that name, or the device is not operational.

D_OUT_OF_BAND

Out-of-band condition occurred on device (such as typing <Ctrl>-C).

D_READ_ONLY

Data cannot be written to this device.

RELATED INFORMATION

Functions: device_get_status.