<h2>device_set_status</h2>

<strong>Function</strong> - Set device status.

<h3>SYNOPSIS</h3>

<strong>#include&lt device/device.h&gt</strong>

<strong>kern_return_t device_set_status</strong>

<strong>(mach_port_t</strong> <var>device</var>,

<strong>dev_flavor_t</strong> <var>flavor</var>,

<strong>dev_status_t</strong> <var>status</var>,

<strong>mach_msg_type_number_t</strong> <var>status_count</var><strong>);</strong>

<h3>PARAMETERS</h3>

<dt> <var>device</var>

[in device send right]

A device port to the device to be manipulated.

<dt> <var>flavor</var>

[in scalar]

The type of status information to set.

<dt> <var>status</var>

[pointer to in array of natural-sized units]

The status information to set.

<dt> <var>status_count</var>

[in scalar]

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

<h3>DESCRIPTION</h3>

The <strong>device_set_status</strong> function sets device status.

The possible values of <var>flavor</var>

as well as the corresponding meanings are device dependent.

<h3>RETURN VALUES</h3>

<dt> <strong>D_DEVICE_DOWN</strong>

Device has been shut down

<dt> <strong>D_IO_ERROR</strong>

Hardware I/O error

<dt> <strong>D_NO_SUCH_DEVICE</strong>

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

<dt> <strong>D_OUT_OF_BAND</strong>

Out-of-band condition occurred on device (such as typing

<strong>&ltCtrl&gt-C</strong>).

<dt> <strong>D_READ_ONLY</strong>

Data cannot be written to this device.

<h3>RELATED INFORMATION</h3>

Functions:

<a href="device_get_status.html"><strong>device_get_status</strong></a>.