xref: /xnu-8792.81.2/osfmk/man/device_set_status.html (revision 19c3b8c28c31cb8130e034cfb5df6bf9ba342d90)

<h2>device_set_status</h2>
<hr>
<p>
<strong>Function</strong> - Set device status.
<h3>SYNOPSIS</h3>
<pre>
<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>
</pre>
<h3>PARAMETERS</h3>
<dl>
<p>
<dt> <var>device</var>
<dd>
[in device send right]
A device port to the device to be manipulated.
<p>
<dt> <var>flavor</var>
<dd>
[in scalar]
The type of status information to set.
<p>
<dt> <var>status</var>
<dd>
[pointer to in array of natural-sized units]
The status information to set.
<p>
<dt> <var>status_count</var>
<dd>
[in scalar]
The size of the status information (in natural-sized units).
</dl>
<h3>DESCRIPTION</h3>
<p>
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>
<dl>
<p>
<dt> <strong>D_DEVICE_DOWN</strong>
<dd>
Device has been shut down
<p>
<dt> <strong>D_IO_ERROR</strong>
<dd>
Hardware I/O error
<p>
<dt> <strong>D_NO_SUCH_DEVICE</strong>
<dd>
No device with that name, or the device is not operational.
<p>
<dt> <strong>D_OUT_OF_BAND</strong>
<dd>
Out-of-band condition occurred on device (such as typing
     <strong>&ltCtrl&gt-C</strong>).
<p>
<dt> <strong>D_READ_ONLY</strong>
<dd>
Data cannot be written to this device.
</dl>
<h3>RELATED INFORMATION</h3>
<p>
Functions:
<a href="device_get_status.html"><strong>device_get_status</strong></a>.