Partager via

SetTapeParameters, fonction (winbase.h)

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

  • Last updated on