[apple/xnu.git] / osfmk / man / device_close.html

<h2>device_close</h2>\r<hr>\r<p>\r<strong>Function</strong> - De-establish a connection to a device.\r<h3>SYNOPSIS</h3>\r<pre>\r<strong>#include&lt device/device.h&gt</strong>\r\r<strong>kern_return_t	device_close</strong>\r		<strong>(mach_port_t</strong>	<var>device</var><strong>);</strong>\r</pre>\r<h3>PARAMETERS</h3>\r<dl>\r<p>\r<dt> <var>device</var> \r<dd>\r[in device send right]\rA device port to the device to be closed.\r</dl>\r<h3>DESCRIPTION</h3>\r<p>\rThe <strong>device_close</strong> function destroys the associated device\rport.  The open count \rfor the named device is decremented.  If this count reaches zero, the close\roperation of the device driver is invoked, closing the device.\r<h3>NOTES</h3>\r<p>\r<strong>device_close</strong> will destroy any mapped device windows\robtained through this\rdevice port.\r<h3>RETURN VALUES</h3>\r<dl>\r<p>\r<dt> <strong>D_NO_SUCH_DEVICE</strong>\r<dd>\rNo device with that name, or the device is not operational.\r</dl>\r<h3>RELATED INFORMATION</h3>\r<p>\rFunctions:\r<a href="device_open.html"><strong>device_open</strong></a>.\r