# FS_WaitAsync

## C Specification

  `#include <nitro/fs.h>`
  `BOOL FS_WaitAsync( FSFile *p_file );`

## Arguments

p_file | Address of the `FSFile` structure

## Return Values

If the asynchronous process is correctly completed, it returns a value of TRUE. Otherwise it returns a value of FALSE.

## Description

If the specified file is currently executing an asynchronous process, this function waits for it to complete. It returns a BOOLEAN value to indicate if the last requested asynchronous process has completed correctly.
If the file is already closed, or if some illegal process has been performed, it returns a value of FALSE.

## Note

This function cannot be called from the interrupt handler (IRQ mode).
Also note that in some cases processing may not end if interrupts are left prohibited.

## See Also

`FSFile FS_ReadFileAsync FS_IsBusy`

## Revision History

11/02/2004 Corrected the function declaration.
09/24/2004 Added text under Caution regarding the conditions for calling this function.
06/15/2004 Revised the description of the operation.
05/14/2004 Initial version.

CONFIDENTIAL