1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<TITLE>HIO2NotifyCallback</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">HIO2NotifyCallback</H1>
12
13<H2>Syntax</H2>
14<dl><dd><pre class="construction">
15typedef int (*HIO2NotifyCallback)( HIO2NotifyEvent event, void* param );
16</pre></dd></dl>
17
18<H2>Arguments</H2>
19<TABLE class="arguments" border="1" >
20  <TBODY>
21    <TR>
22<TH>event</TH>
23      <TD>
24        <TABLE class="arguments" border="1" >
25          <tr>
26<th>HIO2_NOTIFY_INIT_REQUEST</th>
27<td>The <CODE>HIO2Open</CODE> function was called for a device being used by another process.</td>
28          </tr>
29          <tr>
30<th>HIO2_NOTIFY_EXIT_DONE</th>
31<td>Execution of the <CODE>HIO2Exit</CODE> function was completed internally by the library.</td>
32          </tr>
33        </table>
34     </TD>
35    </TR>
36    <TR>
37<TH>param</TH>
38<TD>Argument specified in the <CODE>HIO2Open</CODE> function.</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<H2>Return Values</H2>
44<P>
45When <SPAN class="argument">event</SPAN> is <CODE>HIO_NOTIFY_INIT_REQUEST</CODE>:
46</p>
47<blockquote>
48<table border="1" cellspacing="0.1">
49  <tr>
50    <td width="50" align="center">0</td>
51<td>Request denied (the <CODE>HIO2Open</CODE> function originating the request results in an error).) </td>
52  </tr>
53  <tr>
54    <td width="50" align="center">1</td>
55<td>Request approved (the <CODE>HIOExit2</CODE> function is executed internally by the library when control returns from the callback.)) </td>
56  </tr>
57  <tr>
58    <td width="50" align="center">2</td>
59<td>Processed <CODE>HIO2Exit</CODE> by self (the <CODE>HIO2Exit</CODE> function must be called before control returns from the callback).)</td>
60  </tr>
61</table>
62</blockquote>
63<P>
64When <SPAN class="argument">event</SPAN> is <CODE>HIO_NOTIFY_EXIT_DONE</CODE>:
65</P>
66<blockquote>
67Any value (not accessed when the event is <CODE>HIO_NOTIFY_EXIT_DONE</CODE>).
68</blockquote>
69</P>
70
71<H2>Description</H2>
72<P>
73This function is called when the <CODE>HIO2Open</CODE> function is called for a device being used by another process. It is also called if the call described above is approved.<br>Only for hosts.
74</P>
75
76<H2>See Also</H2>
77<P class="reference">
78<A href="HIO2Open.html"><CODE>HIO2Open</CODE></A>
79</P>
80
81<H2>Revision History</H2>
82<P>
832006/07/26 Corrected errors in <SPAN class="argument">event</SPAN> macro names.<br>2006/05/29 Initial version.<br>
84</P>
85
86<hr><p>CONFIDENTIAL</p></body>
87</HTML>