HalExamineMBR-Funktion (ntddk.h)
Die HalExamineMBR- Routine liest den Master Boot Record (MBR) eines Datenträgers und gibt Daten vom MBR zurück, wenn der MBR vom vom Aufrufer angegebenen Typ ist.
Syntax
void HalExamineMBR(
[in] PDEVICE_OBJECT DeviceObject,
[in] ULONG SectorSize,
[in] ULONG MBRTypeIdentifier,
[out] PVOID *Buffer
);
Parameter
[in] DeviceObject
Ein Zeiger auf das Geräteobjekt für das zu untersuchende Gerät.
[in] SectorSize
Die minimale Anzahl von Bytes, die ein E/A-Vorgang vom zu untersuchenden Gerät abrufen kann. Wenn dieser Wert kleiner als 512 ist, liest HalExamineMBR 512 Byte, um sicherzustellen, dass eine gesamte Partitionstabelle gelesen wird.
[in] MBRTypeIdentifier
MBR-Partitionstypbezeichner. Dieser Parameter gibt den Typ von MBR an, der sich möglicherweise auf dem Datenträger befindet. Weitere Informationen finden Sie in den Hinweisen.
[out] Buffer
Ein Zeiger auf eine Position, an die HalExamineMBR einen Zeiger in einen Puffer schreibt, der Daten aus dem MBR enthält. Das Layout des Puffers hängt vom MBR-Partitionstyp ab. HalExamineMBR den Speicher für diesen Puffer zuweist. Der Aufrufer muss diesen Puffer so schnell wie möglich mit dem Aufruf der ExFreePool-Routine umgehen.
HalExamineMBR- set *Buffer = NULL if the MBR partition type of the disk does not match that specified by MBRTypeIdentifier or if there is an error.
Rückgabewert
Nichts
Bemerkungen
Eine Liste der vom System definierten MBR-Partitionstypbezeichner finden Sie in der Tabelle in PARTITION_INFORMATION. Diese Bezeichner werden in der Ntdddisk.h-Headerdatei definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows XP. |
| Zielplattform- | Universal |
| Header- | ntddk.h (include Ntddk.h) |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |