#include <nitro/wvr.h>
WVRResult WVR_TerminateAsync(
WVRCallbackFunc callback ,
void* arg
);
callback | Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler. |
arg | Designates 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.
This function forcibly stops the wireless driver that is operating on the ARM7-side, and deallocates the VRAM bank it was using. 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 component, which contains features for operating the wireless driver in VRAM, is being used. For all other components, WVR_RESULT_DISABLE
will be returned and this function will fail. If the ichneumon component is being used, only perform the stop process on the driver if the wireless driver has been started by the WVR_StartUpAsync
function. If the asynchronous process for this component completes as expected, the wireless communication features will become unusable. If the communications process was being conducted using the WM library after the driver was started up via the WVR_StartUpAsync
function, the internal state of the WM library will forcibly be put into a READY state. As long as the wireless driver is not restarted via the WVR_StartUpAsync
function the next time, WM_ERRCODE_DISABLE
will be returned to the callbacks in subsequent WM asynchronous operation functions. Be aware that this does not mean that the WM library will be reset to a "pre-initialization state".Call the WM_Finish
function inside the callback of this function when you need to completely shut down the WM library.
06/27/2005 Added statement about callback being called from the interrupt handler.
03/08/2005 Standardized the use of the term 'interrupt' in Japanese.
02/16/2005 Initial version