WriteTapemark

  DWORD WriteTapemark(hDevice, dwTapemarkType, cTapemarks, lpo)    
  HANDLE hDevice; /* open device handle */
  DWORD dwTapemarkType; /* type of tapemarks to write */
  DWORD cTapemarks; /* number of tapemarks to write */
  LPOVERLAPPED lpo; /* overlapped structure */

Parameters

hDevice

Specifies an open handle to the device to write tapemarks on.

dwTapemarkType

Specifies the type of tapemarks to write. This parameter can have one of the following values:

Value Meaning

TAPE_SETMARKS  
  Write setmarks.
TAPE_SHORT_FILEMARKS  
  Write short filemarks.
TAPE_LONG_FILEMARKS  
  Write long filemarks.

cTapemarks

Specifies the number of tapemarks to write.

lpo

Points to an OVERLAPPED structure. The OVERLAPPED structure has the following form:

typedef struct _OVERLAPPED { /* o */

DWORD Internal;

DWORD InternalHigh;

DWORD Offset;

DWORD OffsetHigh;

HANDLE hEvent;

} OVERLAPPED;

typedef OVERLAPPED *LPOVERLAPPED;

Return Value

If the function is successful, the return value is NO_ERROR. Otherwise, it is an error code.