Fonction CreateTapePartition (winbase.h)

Article
03/06/2024

La fonction CreateTapePartition reformate une bande.

Syntaxe

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

Paramètres

[in] hDevice

Gérez vers l’appareil où la nouvelle partition doit être créée. Ce handle est créé à l’aide de la fonction CreateFile .

[in] dwPartitionMethod

Type de partition à créer. Pour déterminer le type de partitions pris en charge par votre appareil, consultez la documentation relative à votre matériel. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur	Signification
TAPE_FIXED_PARTITIONS 0L	Partitionne la bande en fonction de la définition par défaut des partitions de l’appareil. Les paramètres dwCount et dwSize sont ignorés.
TAPE_INITIATOR_PARTITIONS 2L	Partitionne la bande selon le nombre et la taille des partitions spécifiées par dwCount et dwSize, respectivement, à l’exception de la dernière partition. La taille de la dernière partition correspond au reste de la bande.
TAPE_SELECT_PARTITIONS 1L	Partitionne la bande en fonction du nombre de partitions spécifiées par dwCount. Le paramètre dwSize est ignoré. La taille des partitions est déterminée par la taille de partition par défaut de l’appareil. Pour plus d’informations, consultez la documentation relative à votre périphérique à bande.

[in] dwCount

Nombre de partitions à créer. La fonction GetTapeParameters fournit le nombre maximal de partitions qu’une bande peut prendre en charge.

[in] dwSize

Taille de chaque partition, en mégaoctets. Cette valeur est ignorée si le paramètre dwPartitionMethod est TAPE_SELECT_PARTITIONS.

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.

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_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_SETMARK_DETECTED 1103L	Un setmark a été atteint pendant une opération.
ERROR_NO_DATA_DETECTED 1104L	Le marqueur de fin de données a été atteint pendant une opération.
ERROR_PARTITION_FAILURE 1105L	Impossible de partitionner la bande.
ERROR_INVALID_BLOCK_LENGTH 1106L	La taille du bloc est incorrecte sur une nouvelle bande dans une partition multivolume.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Les informations de partition sont introuvables lors du chargement d’une bande.
ERROR_MEDIA_CHANGED 1110L	La bande qui se trouvait dans le lecteur a été remplacée ou supprimée.
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_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

La création de partitions reformate la bande. Toutes les informations précédentes enregistrées sur la bande sont détruites.

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

GetTapeParameters

Partager via