SetTapeParameters, fonction (winbase.h)

Article
08/27/2023

La fonction SetTapeParameters spécifie la taille de bloc d’une bande ou configure le périphérique de bande.

Syntaxe

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

Paramètres

[in] hDevice

Gérez l’appareil pour lequel définir les informations de configuration. Ce handle est créé à l’aide de la fonction CreateFile .

[in] dwOperation

Type d’informations à définir. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SET_TAPE_DRIVE_INFORMATION 1L	Définit les informations spécifiques à l’appareil spécifiées par lpTapeInformation.
SET_TAPE_MEDIA_INFORMATION 0L	Définit les informations spécifiques à la bande spécifiées par le paramètre lpTapeInformation .

[in] lpTapeInformation

Pointeur vers une structure qui contient les informations à définir. Si le paramètre dwOperation est SET_TAPE_MEDIA_INFORMATION, lpTapeInformation pointe vers une structure TAPE_SET_MEDIA_PARAMETERS .

Si dwOperation est SET_TAPE_DRIVE_INFORMATION, lpTapeInformation pointe vers une structure TAPE_SET_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.

Error	Description
ERROR_BEGINNING_OF_MEDIA 1102L	Une 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 limite 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 pas de 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	Une valeur setmark a été atteinte lors d’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


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

GetTapeParameters

TAPE_SET_DRIVE_PARAMETERS

TAPE_SET_MEDIA_PARAMETERS

Partager via