osfmk/man/device_reply_server.html

   1 <h2>device_reply_server</h2>
<hr>
<p>
<strong>Function</strong> - Handle incoming data from kernel device driver.
<h3>SYNOPSIS</h3>
<pre>
<strong>boolean_t     device_reply_server</strong>
           <strong>(mach_msg_header_t</strong>     <var>request_msg</var>,
                <strong>mach_msg_header_t</strong>      <var>reply_msg</var><strong>);</strong>
</pre>
<h3>PARAMETERS</h3>
<dl>
<p>
<dt> <var>request_msg</var> 
<dd>
[pointer to in structure]
The device driver message received from the 
kernel.
<p>
<dt> <var>reply_msg</var> 
<dd>
[out structure]
A reply message.  No messages from a device driver
expect a direct reply, so this field is not used.
</dl>
<h3>DESCRIPTION</h3>
<p>
The <strong>device_reply_server</strong> function is the MIG generated server handling
function to handle messages from kernel device drivers.  Such
messages were sent in response to the various
<strong>device_</strong>...<strong>_request</strong>...
calls.  It is assumed when using 
those calls that some task is listening for reply messages on the port named as a 
reply port to those calls.  The <strong>device_reply_server</strong>
function performs all
necessary argument handling for a kernel message and calls one
of the device server functions to interpret the message.
<h3>RETURN VALUES</h3>
<dl>
<p>
<dt> <strong>TRUE</strong>
<dd>
The message was handled and the appropriate function was called.
<p>
<dt> <strong>FALSE</strong>
<dd>
The message did not apply to this device handler interface and no other 
action was taken.
</dl>
<h3>RELATED INFORMATION</h3>
<p>
Functions:
<a href="device_open.html"><strong>ds_device_open_reply<strong></a>,
<a href="device_write.html"><strong>ds_device_write_reply<strong></a>,
<a href="device_write_inband.html"><strong>ds_device_write_reply_inband<strong></a>,
<a href="device_read.html"><strong>ds_device_read_reply<strong></a>,
<a href="device_read_inband.html"><strong>ds_device_read_reply_inband<strong></a>,
<a href="device_read_overwrite.html"><strong>ds_device_read_reply_overwrite<strong></a>.