The GetTapeStatus function determines whether the tape device is ready to process tape commands.
DWORD GetTapeStatus( HANDLE hDevice );
Handle to 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, it can return one of the following error codes.
||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 tape drive is capable of reporting that it requires cleaning, and reports that it does require cleaning.|
||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.|
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||winbase.h (include Windows.h)|