Target:
#include <revolution/hio2.h>
HIO2Handle HIO2Open( HIO2DeviceType type, HIO2ReceiveCallback callback,
HIO2DisconnectCallback disconnect );
Host:
#include <revolution/hio2.h>
HIO2Handle HIO2Open( HIO2DevicePath pathName, HIO2ReceiveCallback callback,
HIO2NotifyCallback notify, void *param );
Target:
| type | EXI device type. |
|---|---|
| callback | Callback function called when a send notification (mailbox write) from a connected partner is detected. |
| disconnect | Callback function called when the device is disconnected. |
Host:
| pathName | Device path name. |
|---|---|
| callback | Callback function called when a send notification (mailbox write) from a connected partner is detected. |
| notify | Callback function that is called if the HIO2Open function is called for a device that another process is using. |
| param | Parameter used with the callback function notify. |
If handle retrieval fails, this function returns HIO2_INVALID_HANDLE_VALUE; if successful, some other value is returned.
Target: The HIO2Open function opens the specified EXI device.
If the callback function callback has been specified, this callback function is called when a send notification (mailbox write) from a connected partner is detected while the HI02 function does internal processing.
To detect that a device was disconnected, you must specify the callback function disconnect.
Host: The HIO2Open function opens the specified device path.
If the callback function callback has been specified, this callback function is called when a send notification (mailbox write) from a connected partner is detected while the HI02 function does internal processing.
The following dialog box is displayed if another process is using the specified device path.
PID indicates the process ID and Module is the process' file name.
If Stop is selected, the HIO2Open function results in an error; if Retry is selected, initialization is reattempted.
If Retry is selected after the corresponding process terminates, the HIO2Open function succeeds.
If Ignore is selected, it sends a request to issue the HIO2Exit function to the corresponding process. (The library automatically receives the request internally and executes HIO2Exit.))
The callback function notify must be specified in order to detect that another process has called the HIO2Open function.
HIO2Init, HIO2EnumDevices, HIO2Handle, HIO2Exit, HIO2ReceiveCallback, HIO2DisconnectCallback
2006/07/26 Corrected mistake in the types of the arguments of HIO2Open on the host side.
2006/05/29 Added links to HIO2ReceiveCallback and HIO2DisconnectCallback.
2006/03/01 Initial version.
CONFIDENTIAL