The GetTapeStatus function indicates whether the tape device is ready to process tape commands.
DWORD GetTapeStatus(
|
HANDLE hDevice |
// handle of open device |
|
); |
If the tape device is ready to accept appropriate tape-access commands without returning errors, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes:
|
Error code |
Description |
|
ERROR_BEGINNING_OF_MEDIA |
An attempt to access data before the beginning-of-medium marker failed. |
|
ERROR_BUS_RESET |
A reset condition was detected on the bus. |
|
ERROR_END_OF_MEDIA |
The end-of-tape marker was reached during an operation. |
|
ERROR_FILEMARK_DETECTED |
A filemark was reached during an operation. |
|
ERROR_SETMARK_DETECTED |
A setmark was reached during an operation. |
|
ERROR_NO_DATA_DETECTED |
The end-of-data marker was reached during an operation. |
|
ERROR_PARTITION_FAILURE |
The tape could not be partitioned. |
|
ERROR_INVALID_BLOCK_LENGTH |
The block size is incorrect on a new tape in a multivolume partition. |
|
ERROR_DEVICE_NOT_PARTITIONED |
The partition information could not be found when a tape was being loaded. |
|
ERROR_MEDIA_CHANGED |
The tape that was in the drive has been replaced or removed. |
|
ERROR_NO_MEDIA_IN_DRIVE |
There is no media in the drive. |
|
ERROR_NOT_SUPPORTED |
The tape driver does not support a requested function. |
|
ERROR_UNABLE_TO_LOCK_MEDIA |
An attempt to lock the ejection mechanism failed. |
|
ERROR_UNABLE_TO_UNLOAD_MEDIA |
An attempt to unload the tape failed. |
|
ERROR_WRITE_PROTECT |
The media is write protected. |