Fonction IoWritePartitionTableEx (ntddk.h)
La routine IoWritePartitionTableEx écrit des tables de partition à partir des entrées de la mémoire tampon de liste de partitions pour chaque partition sur le disque représenté par l’objet d’appareil donné.
Syntaxe
NTSTATUS IoWritePartitionTableEx(
[in] PDEVICE_OBJECT DeviceObject,
_DRIVE_LAYOUT_INFORMATION_EX *DriveLayout
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil représentant le disque dont les tables de partition doivent être écrites.
DriveLayout
Pointeur vers la mémoire tampon de disposition de lecteur qui contient les entrées de liste de partitions. Pour plus d’informations, consultez DRIVE_LAYOUT_INFORMATION_EX.
Valeur retournée
IoWritePartitionTableEx retourne un code status de STATUS_SUCCESS si toutes les écritures ont été effectuées sans erreur. En cas d’échec, les codes d’erreur retournés par IoWritePartitionTableEx peuvent inclure, sans s’y limiter, la liste suivante :
| Code de retour | Description |
|---|---|
| STATUS_DEVICE_NOT_READY | Indique un échec de lecture de la géométrie de disque correcte. |
| STATUS_INSUFFICIENT_RESOURCES | Indique un échec d’allocation des ressources nécessaires (par exemple, mémoire du tas, IRP, etc.). |
| STATUS_UNSUCCESSFUL | Indique que le secteur zéro n’avait pas la signature de disque MBR attendue. |
Remarques
IoWritePartitionTableEx remplace la routine obsolète IoWritePartitionTable. Contrairement à l’ancienne routine, il peut écrire dans des tables de partition GUID ainsi que dans des tables de partition d’enregistrement de démarrage principal.
IoWritePartitionTableEx doit uniquement être utilisé par les pilotes de disque. Les autres pilotes doivent utiliser la demande d’E /S IOCTL_DISK_SET_DRIVE_LAYOUT_EX disque à la place.
Lorsqu’un pilote de périphérique de disque reçoit une demande de IRP_MJ_DEVICE_CONTROL pour définir le type de partition dans une entrée de table de partition ou pour repartitionner le disque, il doit appeler IoWritePartitionTableEx. La demande de contrôle d’appareil est généralement émise par l’utilitaire de format, qui exécute des fonctions de contrôle d’E/S sur les partitions et les disques de l’ordinateur.
Pour réinitialiser un type de partition, le pilote passe un pointeur vers l’objet de périphérique, représentant le disque physique et le numéro de la partition associée à l’objet de périphérique que l’utilitaire de format a ouvert. Lorsqu’un disque doit être repartitionné dynamiquement, le pilote de disque doit supprimer son ensemble d’objets de périphérique représentant les partitions de disque actuelles et créer un ensemble d’objets d’appareil représentant les nouvelles partitions sur le disque.
Pour créer ou supprimer des partitions, une description complète du système doit être obtenue par un appel à IoReadPartitionTableEx. La structure de disposition du lecteur peut être modifiée par l’utilitaire de format système pour refléter une nouvelle configuration du disque.
IoWritePartitionTableEx est synchrone. Il doit être appelé par la routine Dispatch du pilote de disque ou par un thread de pilote. Par conséquent, tous les threads de système de fichiers et d’utilisateur doivent être prêts à entrer un état d’attente lors de l’émission de la demande de contrôle de l’appareil pour réinitialiser les types de partition pour l’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntddk.h (incluez Ntddk.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |