Reads the sectors requested from a file using DFS, returning after initiation.
#include <dfs.h>
int dfs_readnowait (
int fildes,
uint32_t startingSector,
size_t sectorCount,
void *buffer,
dfs_cbparms_t *cbNode );
(IN) Specifies the file handle returned from a prior call to open for the indicated file.
(IN) Specifies the starting sector number (logical offset from beginning of file) in the file where the read operation is to begin.
(IN) Specifies the number of sectors to be read into the buffer.
(OUT) Points to a contiguous buffer area large enough to contain the number of sectors indicated to be read.
(IN) Pointer to a structure used to signal completion of all requested reads for a particular call to dfs_readnowait.
If successful in initiating the request, returns 0. Otherwise, returns a nonzero error code:
The actual completion is stored in the ccode field of the dfs_cbparms_t structure upon completion of the request. For possible DFS errors, see Section 13.4.5, DFS Return Values.
This function is identical to dfs_read, except that the function caller returns immediately after posting the reads to the driver. This means that the status returned from the function only indicates whether the call was initiated or not. The completion status is returned in the structure provided for completion notification.
A calling process must allow other processes to run. Consequently, any long sequence of code including this function call should call a thread yield function to allow other processes to execute.