IoWritePartitionTable, fonction (ntddk.h)
La routine IoWritePartitionTable est obsolète et est fournie uniquement pour prendre en charge les pilotes existants. Les nouveaux pilotes doivent utiliser IoWritePartitionTableEx.
IoWritePartitionTable écrit des tables de partition à partir des entrées de la mémoire tampon de la liste de partitions pour chaque partition sur le disque représenté par l’objet appareil donné.
Syntaxe
NTSTATUS IoWritePartitionTable(
[in] PDEVICE_OBJECT DeviceObject,
[in] ULONG SectorSize,
[in] ULONG SectorsPerTrack,
[in] ULONG NumberOfHeads,
[in] _DRIVE_LAYOUT_INFORMATION *PartitionBuffer
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil représentant le disque dont les tables de partition doivent être écrites.
[in] SectorSize
Spécifie la taille en octets des secteurs sur l’appareil.
[in] SectorsPerTrack
Spécifie la taille du suivi sur l’appareil.
[in] NumberOfHeads
Spécifie le nombre de pistes par cylindre.
[in] PartitionBuffer
Pointeur vers la mémoire tampon de disposition du lecteur qui contient les entrées de liste de partitions. Pour plus d’informations, consultez DRIVE_LAYOUT_INFORMATION.
Valeur de retour
IoWritePartitionTablo retourne un code d’état de STATUS_SUCCESS si toutes les écritures ont été effectuées sans erreur. En cas de défaillance, les codes d’erreur retournés par IoWritePartitionTable peuvent inclure, mais ne sont pas limités à la liste suivante :
| Retourner le code | Description |
|---|---|
| STATUS_DEVICE_NOT_READY | Indique qu’une défaillance lit 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, IRPs, etc.). |
| STATUS_UNSUCCESSFUL | Indique que le secteur zéro n’avait pas la signature de disque MBR attendue. |
Remarques
IoWritePartitionTable ne doit être utilisé que par les pilotes de disque. D’autres pilotes doivent utiliser la demande d’E/S de disque IOCTL_DISK_SET_DRIVE_LAYOUT à la place.
IoWritePartitionTable est appelée lorsqu’un pilote de périphérique de disque est demandé pour définir le type de partition dans une entrée de table de partition ou pour repartitionner le disque par une requête IRP_MJ_DEVICE_CONTROL. La demande de contrôle d’appareil est généralement émise par l’utilitaire de format, qui effectue 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 transmet un pointeur vers l’objet de périphérique représentant le disque physique et le nombre de partition associée à l’objet d’appareil que l’utilitaire de format a ouvert. Lorsqu’un disque doit être repartitionné dynamiquement, le pilote de disque doit supprimer son ensemble d’objets d’appareil représentant les partitions de disque actuelles et créer un nouvel ensemble d’objets d’appareil représentant les nouvelles partitions sur le disque.
Les applications qui créent et suppriment des partitions et nécessitent des descriptions complètes du système doivent appeler IoReadPartitionTable avec ReturnRecognizedPartitions défini sur FALSE. 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.
IoWritePartitionTable est synchrone. Elle doit être appelée par la routine Dispatch du pilote de disque ou par un thread de pilote. Ainsi, 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 d’appareil pour réinitialiser les types de partitions pour l’appareil.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |