GetTapeParameters, fonction (winbase.h)

Article
08/27/2023

La fonction GetTapeParameters récupère des informations qui décrivent la bande ou le lecteur de bande.

Syntaxe

DWORD GetTapeParameters(
  [in]  HANDLE  hDevice,
  [in]  DWORD   dwOperation,
  [out] LPDWORD lpdwSize,
  [out] LPVOID  lpTapeInformation
);

Paramètres

[in] hDevice

Gérez l’appareil sur lequel les informations sont recherchées. Ce handle est créé à l’aide de la fonction CreateFile .

[in] dwOperation

Type d’informations demandées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
GET_TAPE_DRIVE_INFORMATION 1	Récupère des informations sur le périphérique de bande.
GET_TAPE_MEDIA_INFORMATION 0	Récupère des informations sur la bande dans le périphérique à bande.

[out] lpdwSize

Pointeur vers une variable qui reçoit la taille, en octets, de la mémoire tampon spécifiée par le paramètre lpTapeInformation . Si la mémoire tampon est trop petite, ce paramètre reçoit la taille requise.

[out] lpTapeInformation

Pointeur vers une structure qui contient les informations demandées. Si le paramètre dwOperation est GET_TAPE_MEDIA_INFORMATION, lpTapeInformation pointe vers une structure TAPE_GET_MEDIA_PARAMETERS .

Si dwOperation est GET_TAPE_DRIVE_INFORMATION, lpTapeInformation pointe vers une structure TAPE_GET_DRIVE_PARAMETERS .

Valeur retournée

Si la fonction réussit, 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_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.

Remarques

Les valeurs de plage de taille de bloc (maximale et minimale) retournées par la fonction GetTapeParameters appelée avec le paramètre dwOperation défini sur la valeur GET_TAPE_DRIVE_INFORMATION indiquent les limites système, et non les limites du lecteur. Toutefois, ce sont le lecteur de bande et le support présents dans le lecteur qui déterminent les limites de taille de blocs véritables. Par conséquent, une application peut ne pas être en mesure de définir toutes les tailles de blocs mentionnées dans la plage obtenue en spécifiant GET_TAPE_DRIVE_INFORMATION dans dwOperation.

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

SetTapeParameters

TAPE_GET_DRIVE_PARAMETERS

TAPE_GET_MEDIA_PARAMETERS

Partager via