|
GetTapeStatus The GetTapeStatus function indicates whether the tape device is ready to process tape commands. VB4-32,5,6 Declare Function GetTapeStatus Lib "kernel32" Alias "GetTapeStatus" (ByVal hDevice As Long) As Long |
Operating Systems Supported |
Requires Windows NT 3.1 or later; Win9x/ME: Not supported |
· hDevice Identifies the device for which to get the device status. This handle is created by using the CreateFile function. |
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_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. |
|
|
|