SetTapeParameters function (winbase.h)
The SetTapeParameters function either specifies the block size of a tape or configures the tape device.
DWORD SetTapeParameters(
[in] HANDLE hDevice,
[in] DWORD dwOperation,
[in] LPVOID lpTapeInformation
);
[in] hDevice
Handle to the device for which to set configuration information. This handle is created by using the CreateFile function.
[in] dwOperation
Type of information to set. This parameter must be one of the following values.
[in] lpTapeInformation
Pointer to a structure that contains the information to set. If the dwOperation parameter is SET_TAPE_MEDIA_INFORMATION, lpTapeInformation points to a TAPE_SET_MEDIA_PARAMETERS structure.
If dwOperation is SET_TAPE_DRIVE_INFORMATION, lpTapeInformation points to a TAPE_SET_DRIVE_PARAMETERS structure.
If the function succeeds, the return value is NO_ERROR.
If the function fails, it can return one of the following error codes.
Error | Description |
---|---|
|
An attempt to access data before the beginning-of-medium marker failed. |
|
A reset condition was detected on the bus. |
|
The partition information could not be found when a tape was being loaded. |
|
The end-of-tape marker was reached during an operation. |
|
A filemark was reached during an operation. |
|
The block size is incorrect on a new tape in a multivolume partition. |
|
The tape that was in the drive has been replaced or removed. |
|
The end-of-data marker was reached during an operation. |
|
There is no media in the drive. |
|
The tape driver does not support a requested function. |
|
The tape could not be partitioned. |
|
A setmark was reached during an operation. |
|
An attempt to lock the ejection mechanism failed. |
|
An attempt to unload the tape failed. |
|
The media is write protected. |
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | winbase.h (include Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |