fonction de rappel pHalExamineMBR (ntddk.h)
La routine HalExamineMBR lit l’enregistrement de démarrage principal (MBR) d’un disque et retourne les données du MBR si le MBR est du type spécifié par l’appelant.
Syntaxe
pHalExamineMBR Phalexaminembr;
void Phalexaminembr(
[in] PDEVICE_OBJECT DeviceObject,
[in] ULONG SectorSize,
[in] ULONG MBRTypeIdentifier,
[out] PVOID *Buffer
)
{...}
Paramètres
[in] DeviceObject
Pointeur vers l’objet appareil pour l’appareil examiné.
[in] SectorSize
Nombre minimal d’octets qu’une opération d’E/S peut extraire de l’appareil en cours d’examen. Si cette valeur est inférieure à 512, HalExamineMBR lit 512 octets pour s’assurer qu’elle 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 Remarques.
[out] Buffer
Pointeur vers un emplacement vers lequel HalExamineMBR écrit un pointeur dans 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 *Tampon = NULL si le type de partition MBR du disque ne correspond pas à celui spécifié par MBRTypeIdentifier ou s’il existe une erreur.
Valeur de retour
Aucun
Remarques
Pour obtenir la liste des identificateurs de type de partition MBR définis par le système, consultez la table dans PARTITION_INFORMATION. Ces identificateurs sont définis dans le fichier d’en-tête Ntdddisk.h.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows XP. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |