Syntax

  #include <nwdfs.h>  
   
  LONG DFSWriteNoWait  (  
     LONG            fileHandle,   
     LONG            startingSector,   
     LONG            sectorCount,   
     BYTE           *buffer,   
     struct DFSCallBackParameters   *callBackNode); 
  

Parameters

fileHandle

(IN) Specifies the file handle returned from a prior DFSsopen call for the file.

startingSector

(IN) Specifies the starting sector number in the file (logical offset from beginning of file) where the write operation is to begin.

sectorCount

(IN) Specifies the number of sectors to be written from the buffer.

buffer

(IN) Points to a contiguous buffer area large enough to contain the number of sectors to be written.

callBackNode

(IN) Points to a structure used to signal completion of all requested writes for a particular call to DFSWriteNoWait.

Return Values

This function can also return the return status codes found in the DFSWrite information above.

Remarks

Operation is identical to DFSWrite except that the current thread of execution is not blocked until the completion of the requested operation ( DFSWrite calls DFSWriteNoWait, then waits for the completion to be signalled).

The localSemaphoreHandle field contains a local semaphore handle obtained by calling OpenLocalSemaphore. WaitOnLocalSemaphore or ExamineLocalSemaphore should be called to determine when the semaphore has been signalled.

The completionCode field contains a zero (or the value already in the field if it has not been zeroed out before DFSWriteNoWait is called) if a bad file handle is passed, and a -1 for all other completions.

See Also

DFSExpandFile, DFSWrite