HIO2Open

C Specification

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 );

Arguments

Target:

`type`	EXI device type.
`callback`	Callback function called when a send notification (mailbox write) from another 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 another 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.

Return Values

If handle retrieval fails, this function returns HIO2_INVALID_HANDLE_VALUE; if successful, another value is returned.

Description

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 represents the process ID and Module represents 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, the HIO2Init function sends a request to issue the HIO2Exit function to the corresponding process. (The library automatically receives the request internally and executes HIO2Exit.)j

The callback function notify must be specified to detect that another process has called theHIO2Open function.

Revision History

07/26/2006 Corrected mistake in the type of the function HIO2Open on the host side.

05/29/2006 Added links to HIO2ReceiveCallback and HIO2DisconnectCallback

03/01/2006 Initial version.