
#include <nitro/wvr.h>
WVRResult WVR_StartUpAsync(
GXVRamARM7 vram ,
WVRCallbackFunc callback ,
void* arg
);
| vram | VRAM bank to allocate to ARM7. The ARM7-side wireless driver begins to operate on this VRAM. Below are the possible configuration values.
|
| callback | Callback function to call when the asynchronous process completes. This callback is called from inside the interrupt handler. |
| arg | Optional arguments to be passed to the callback function called when the asynchronous process is complete. |
Returns the results of the WVRResult enumerated type process.
Allocates a VRAM bank to the ARM7-side wireless driver and then starts the operations for that driver. If the return value was WVR_RESULT_OPERATING, the callback function is called from inside the PXI receive interrupt handler when the asynchronous process is complete.
This function is relevant only when the ichneumon or ichneumon.TWL components, which contains features for operating the wireless driver in VRAM, are being used. For all other components, WVR_RESULT_DISABLE is returned, and this function fails. If the ichneumon or ichneumon.TWL component is being used, the wireless communication features cannot be used as long as the wireless driver is not put into operation via this function. Before the wireless driver starts up, the WM_Init function returns WM_ERRCODE_DISABLE and fails.
The wireless driver can only be allocated to the VRAM banks VRAM-C and VRAM-D, but if these VRAM banks are already allocated for another application by the GX library, this function fails. In that case, try to call this function after putting the VRAM bank to be used into a "Not allocated for any application" state with a function such as GX_DisableBankFor*. Conversely, if the VRAM bank is allocated to the wireless driver via this function, the designated VRAM bank is unable to be allocated for any other application until the wireless driver is stopped by the WVR_TerminateAsync function.
There are no differences for the wireless driver due to the VRAM that is allocated. The allocation of either VRAM-C or VRAM-D has the same effect on the operations of the wireless driver. Select the VRAM to allocate according to how VRAM-C and VRAM-D are used.
Before calling this function, you must call the OS_InitLock or OS_Init function.
2009/06/15 Added a description related to the ichneumon.TWL component. 2005/06/27 Added a statement about the callback being called from the interrupt handler. 2005/03/14 Corrected a mistake with a link destination.
2005/03/08 Standardized the Japanese word for interrupt. 2005/03/01 Added to Description.
2005/02/16 Initial version.
CONFIDENTIAL