Partager via

GetTapeStatus, fonction (winbase.h)

  • Article

La fonction GetTapeStatus détermine si le périphérique de bande est prêt à traiter les commandes de bande.

Syntaxe

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

Paramètres

[in] hDevice

Gérez vers l’appareil pour lequel obtenir l’appareil status. Ce handle est créé à l’aide de la fonction CreateFile .

Valeur retournée

Si le périphérique à bande est prêt à accepter les commandes d’accès à bande appropriées sans retourner d’erreurs, la valeur de retour est NO_ERROR.

Si la fonction échoue, elle peut retourner l’un des codes d’erreur suivants.

Code d'erreur Description
ERROR_BEGINNING_OF_MEDIA
1102L
 Tentative d’accès aux données avant l’échec du marqueur de début du moyen.
ERROR_BUS_RESET
1111L
 Une condition de réinitialisation a été détectée sur le bus.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 Les informations de partition sont introuvables lors du chargement d’une bande.
ERROR_DEVICE_REQUIRES_CLEANING
1165L
 Le lecteur de bande est capable de signaler qu’il nécessite un nettoyage et signale qu’il nécessite un nettoyage.
ERROR_END_OF_MEDIA
1100L
 Le marqueur de fin de bande a été atteint lors d’une opération.
ERROR_FILEMARK_DETECTED
1101L
 Une marque de fichier a été atteinte lors d’une opération.
ERROR_INVALID_BLOCK_LENGTH
1106L
 La taille du bloc est incorrecte sur une nouvelle bande dans une partition multivolume.
ERROR_MEDIA_CHANGED
1110L
 La bande qui se trouvait dans le lecteur a été remplacée ou supprimée.
ERROR_NO_DATA_DETECTED
1104L
 Le marqueur de fin de données a été atteint pendant une opération.
ERROR_NO_MEDIA_IN_DRIVE
1112L
 Il n’y a aucun média dans le lecteur.
ERROR_NOT_SUPPORTED
50L
 Le pilote de bande ne prend pas en charge une fonction demandée.
ERROR_PARTITION_FAILURE
1105L
 Impossible de partitionner la bande.
ERROR_SETMARK_DETECTED
1103L
 Un setmark a été atteint pendant une opération.
ERROR_UNABLE_TO_LOCK_MEDIA
1108L
 Une tentative de verrouillage du mécanisme d’éjection a échoué.
ERROR_UNABLE_TO_UNLOAD_MEDIA
1109L
 Une tentative de déchargement de la bande a échoué.
ERROR_WRITE_PROTECT
19L
 Le support est protégé en écriture.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CreateFile