SetTapeParameters

DWORD SetTapeParameters(hDevice, dwOperation, plInfoBuffer, lpo)
HANDLE hDevice;	/* open device handle	*/
DWORD dwOperation;	/* type of information to set	*/
PLONG plInfoBuffer;	/* buffer for information to set	*/
LPOVERLAPPED lpo;	/* overlapped structure	*/

Parameters

hDevice

Specifies an open handle to the device to set information for.

dwOperation

Specifies the type of tape information to set.

If dwOperation is SET_TAPE_MEDIA_INFORMATION, plInfoBuffer points to a DWORD that contains the number of bytes per tape block.

If dwOperation is SET_TAPE_DRIVE_INFORMATION, plInfoBuffer points to a DWORD that contains flags that control the tape drive, as shown in the following list:

Value

Meaning

TAPE_DRIVE_ECC
	Set hardware error correction on or off.
TAPE_DRIVE_COMPRESSION
	Set hardware data compression on or off.
TAPE_DRIVE_PADDING
	Set data padding on or off.

plInfoBuffer

Points to a buffer that contains the information to set, based on the dwOperation parameter.

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.