MINIPORT_DUMP_POINTERS Struktur (storport.h)
Ein Storport-Miniporttreiber verwendet diese Struktur, um den SCSI_REQUEST_BLOCK (SRB)-Funktionscode SRB_FUNCTION_DUMP_POINTERS zu unterstützen. Wenn ein Miniporttreiber diese Art von SRB empfängt, verweist der DataBuffer SRB-Member auf eine MINIPORT_DUMP_POINTERS Struktur. Dieser SRB wird an den Miniporttreiber gesendet, der verwendet wird, um den Datenträger zu steuern, der die Absturzabbilddaten enthält, nachdem der SRB von der HwStorInitialize Routine des Miniporttreibers zurückgegeben wurde. Virtuelle Miniporttreiber sind erforderlich, um SRB_FUNCTION_DUMP_POINTERS zu unterstützen.
Syntax
typedef struct _MINIPORT_DUMP_POINTERS {
USHORT Version;
USHORT Size;
WCHAR DriverName[DUMP_MINIPORT_NAME_LENGTH];
struct _ADAPTER_OBJECT *AdapterObject;
PVOID MappedRegisterBase;
ULONG CommonBufferSize;
PVOID MiniportPrivateDumpData;
ULONG SystemIoBusNumber;
INTERFACE_TYPE AdapterInterfaceType;
ULONG MaximumTransferLength;
ULONG NumberOfPhysicalBreaks;
ULONG AlignmentMask;
ULONG NumberOfAccessRanges;
ACCESS_RANGE( ) *AccessRanges[];
UCHAR NumberOfBuses;
BOOLEAN Master;
BOOLEAN MapBuffers;
UCHAR MaximumNumberOfTargets;
} MINIPORT_DUMP_POINTERS, *PMINIPORT_DUMP_POINTERS;
Angehörige
Version
Auf DUMP_MINIPORT_VERSION_1 festgelegt.
Size
Auf sizeof(MINIPORT_DUMP_POINTERS) festgelegt.
DriverName[DUMP_MINIPORT_NAME_LENGTH]
Der Breitzeichenname des Miniporttreibers ohne Pfadinformationen (z. B. Miniport.sys).
AdapterObject
Wird auf NULL-festgelegt.
MappedRegisterBase
Auf Null festgelegt.
CommonBufferSize
Die Größe des allgemeinen Puffers, der erforderlich ist. Die Größe darf nicht größer als 64 KB (65.536 Bytes) sein.
MiniportPrivateDumpData
Der Kontext, der während des Absturzabbilds an die HwStorFind Adapter des Miniporttreibers übergeben werden soll. Der Kontext wird im Reserved Member übergeben oder ab Windows 8 das MiniportDumpData- Mitglied der PORT_CONFIGURATION_INFORMATION-Struktur.
SystemIoBusNumber
Gibt die vom System zugewiesene Nummer des E/A-Busses an, mit dem die HBA verbunden ist. Der Storport-Treiber initialisiert dieses Element. Miniport-Treiber, die mit dem Storport-Treiber arbeiten, dürfen dieses Mitglied nicht ändern. Weitere Informationen finden Sie im SystemIoBusNumber Mitglied von PORT_CONFIGURATION_INFORMATION.
AdapterInterfaceType
Identifiziert die E/A-Busschnittstelle. Der Storport-Treiber initialisiert dieses Element. Miniport-Treiber, die mit dem Storport-Treiber arbeiten, dürfen dieses Element nicht ändern. Weitere Informationen finden Sie im AdapterInterfaceType Member von PORT_CONFIGURATION_INFORMATION.
MaximumTransferLength
Gibt die maximale Anzahl von Bytes an, die die HBA in einem einzelnen Übertragungsvorgang im Absturzdumpmodus übertragen kann. Standardmäßig ist der Wert dieses Elements SP_UNINITIALIZED_VALUE, der eine unbegrenzte maximale Übertragungsgröße angibt. Dieser Wert ist spezifisch für den Dumpvorgang des Miniports und kann sich vom Wert im MaximumTransferLength Member von PORT_CONFIGURATION_INFORMATIONunterscheiden.
NumberOfPhysicalBreaks
Gibt die maximale Anzahl von Umbrüchen zwischen Adressbereichen an, die ein Datenpuffer zum Erstellen von Punkt/Gather-Listen haben kann. Anders ausgedrückt: Die Anzahl der XY/Gather-Listeneinträge, die der Adapter unterstützen kann minus 1. Weitere Informationen finden Sie im NumberOfPhysicalBreaks Member von PORT_CONFIGURATION_INFORMATION.
AlignmentMask
Enthält eine Maske, die die Ausrichtungseinschränkungen für Puffer angibt, die vom HBA für Übertragungsvorgänge erforderlich sind. Gültige Maskenwerte sind auch durch Merkmale der Speichermanager in verschiedenen Versionen von Microsoft Windows-Betriebssystemen eingeschränkt. Die gültigen Maskenwerte sind 0 (byte aligned), 0x1 (word aligned), 0x3 (DWORD aligned) und 0x7 (double DWORD aligned). Der Miniporttreiber sollte diese Maske festlegen, wenn die HBA Punkt/Erfassung unterstützt. Dieselben Überlegungen gelten für das AlignmentMask Member von PORT_CONFIGURATION_INFORMATION.
NumberOfAccessRanges
Gibt die Anzahl der AccessRanges- Elemente im Array an. Weitere Informationen finden Sie im NumberOfAccessRanges Member von PORT_CONFIGURATION_INFORMATION.
AccessRanges
Ein Zeiger auf ein Array von ACCESS_RANGE-Typelementen. Der Storport-Treiber initialisiert dieses Element. Miniport-Treiber, die mit dem Storport-Treiber arbeiten, dürfen dieses Mitglied nicht ändern. Weitere Informationen finden Sie im AccessRanges Mitglied von PORT_CONFIGURATION_INFORMATION.
NumberOfBuses
Gibt die Anzahl der Vom Adapter gesteuerten Busse an. Standardmäßig ist der Wert dieses Elements Null. Weitere Informationen finden Sie im NumberOfBuses Mitglied von PORT_CONFIGURATION_INFORMATION.
Master
Gibt an, wenn TRUE, dass die HBA ein Busmaster ist. Der Storport-Treiber initialisiert dieses Mitglied in TRUE, da seine Miniporttreiber das Busmastering-DMA unterstützen müssen. Miniport-Treiber, die mit dem Storport-Treiber arbeiten, dürfen diesen Wert nicht ändern. Weitere Informationen finden Sie im Master Member von PORT_CONFIGURATION_INFORMATION.
MapBuffers
Gibt an, ob der Storport-Treiber SRB-Datenpufferadressen system virtual addresses zuordnet. Weitere Informationen finden Sie im MapBuffers Mitglied von HW_INITIALIZATION_DATA.
MaximumNumberOfTargets
Gibt die Anzahl der Zielperipheriegeräte an, die der Adapter steuern kann. Weitere Informationen finden Sie im MaximumNumberOfTargets Member von PORT_CONFIGURATION_INFORMATION.
Bemerkungen
Ab Windows 8 können physische Miniporttreiber optional SRB_FUNCTION_DUMP_POINTERS unterstützen. Wenn ein physischer Miniport diese Funktion unterstützt, muss es das STOR_FEATURE_DUMP_POINTERS Flag im FeatureSupport- Member der HW_INITIALIZATION_DATA-Struktur festlegen, bevor StorPortInitializeaufgerufen wird. Physische Miniports sind erforderlich, um mindestens die Version und Size Member von MINIPORT_DUMP_POINTERSfestzulegen. Wenn sich der in PORT_CONFIGURATION_INFORMATIONangegebene Wert unterscheidet, ist auch das MaximumTransferLength Member für einen physischen Miniport erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | storport.h (include Storport.h) |