xref: /xnu-11417.101.15/osfmk/man/device_close.html (revision e3723e1f17661b24996789d8afc084c0c3303b26)
1*e3723e1fSApple OSS Distributions<h2>device_close</h2>
2*e3723e1fSApple OSS Distributions<hr>
3*e3723e1fSApple OSS Distributions<p>
4*e3723e1fSApple OSS Distributions<strong>Function</strong> - De-establish a connection to a device.
5*e3723e1fSApple OSS Distributions<h3>SYNOPSIS</h3>
6*e3723e1fSApple OSS Distributions<pre>
7*e3723e1fSApple OSS Distributions<strong>#include&lt device/device.h&gt</strong>
8*e3723e1fSApple OSS Distributions
9*e3723e1fSApple OSS Distributions<strong>kern_return_t	device_close</strong>
10*e3723e1fSApple OSS Distributions		<strong>(mach_port_t</strong>	<var>device</var><strong>);</strong>
11*e3723e1fSApple OSS Distributions</pre>
12*e3723e1fSApple OSS Distributions<h3>PARAMETERS</h3>
13*e3723e1fSApple OSS Distributions<dl>
14*e3723e1fSApple OSS Distributions<p>
15*e3723e1fSApple OSS Distributions<dt> <var>device</var>
16*e3723e1fSApple OSS Distributions<dd>
17*e3723e1fSApple OSS Distributions[in device send right]
18*e3723e1fSApple OSS DistributionsA device port to the device to be closed.
19*e3723e1fSApple OSS Distributions</dl>
20*e3723e1fSApple OSS Distributions<h3>DESCRIPTION</h3>
21*e3723e1fSApple OSS Distributions<p>
22*e3723e1fSApple OSS DistributionsThe <strong>device_close</strong> function destroys the associated device
23*e3723e1fSApple OSS Distributionsport.  The open count
24*e3723e1fSApple OSS Distributionsfor the named device is decremented.  If this count reaches zero, the close
25*e3723e1fSApple OSS Distributionsoperation of the device driver is invoked, closing the device.
26*e3723e1fSApple OSS Distributions<h3>NOTES</h3>
27*e3723e1fSApple OSS Distributions<p>
28*e3723e1fSApple OSS Distributions<strong>device_close</strong> will destroy any mapped device windows
29*e3723e1fSApple OSS Distributionsobtained through this
30*e3723e1fSApple OSS Distributionsdevice port.
31*e3723e1fSApple OSS Distributions<h3>RETURN VALUES</h3>
32*e3723e1fSApple OSS Distributions<dl>
33*e3723e1fSApple OSS Distributions<p>
34*e3723e1fSApple OSS Distributions<dt> <strong>D_NO_SUCH_DEVICE</strong>
35*e3723e1fSApple OSS Distributions<dd>
36*e3723e1fSApple OSS DistributionsNo device with that name, or the device is not operational.
37*e3723e1fSApple OSS Distributions</dl>
38*e3723e1fSApple OSS Distributions<h3>RELATED INFORMATION</h3>
39*e3723e1fSApple OSS Distributions<p>
40*e3723e1fSApple OSS DistributionsFunctions:
41*e3723e1fSApple OSS Distributions<a href="device_open.html"><strong>device_open</strong></a>.
42