Fonction HalExamineMBR (ntddk.h)
La routine HalExamineMBR lit l’enregistrement de démarrage master (MBR) d’un disque et retourne des données à partir du MBR si le MBR est du type spécifié par l’appelant.
Syntaxe
void HalExamineMBR(
[in] PDEVICE_OBJECT DeviceObject,
[in] ULONG SectorSize,
[in] ULONG MBRTypeIdentifier,
[out] PVOID *Buffer
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet d’appareil pour l’appareil examiné.
[in] SectorSize
Nombre minimal d’octets qu’une opération d’E/S peut extraire de l’appareil examiné. Si cette valeur est inférieure à 512, HalExamineMBR lit 512 octets pour s’assurer qu’il lit une table de partition entière.
[in] MBRTypeIdentifier
Identificateur de type de partition MBR. Ce paramètre spécifie le type de MBR qui peut se trouver sur le disque. Pour plus d'informations, consultez la section Notes.
[out] Buffer
Pointeur vers un emplacement dans lequel HalExamineMBR écrit un pointeur vers une mémoire tampon qui contient des données du MBR. La disposition de la mémoire tampon dépend du type de partition MBR. HalExamineMBR alloue le stockage pour cette mémoire tampon. L’appelant doit libérer cette mémoire tampon dès que possible en appelant la routine ExFreePool .
HalExamineMBR définit *Buffer = NULL si le type de partition MBR du disque ne correspond pas à celui spécifié par MBRTypeIdentifier ou en cas d’erreur.
Valeur de retour
None
Remarques
Pour obtenir la liste des identificateurs de type de partition MBR définis par le système, consultez le tableau dans PARTITION_INFORMATION. Ces identificateurs sont définis dans le fichier d’en-tête Ntdddisk.h.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows XP. |
Plateforme cible | Universal |
En-tête | ntddk.h (incluez Ntddk.h) |
IRQL | PASSIVE_LEVEL |
Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |