Fonction HalExamineMBR (ntddk.h)

  • Article

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)

Voir aussi

ExFreePool

PARTITION_INFORMATION