structure MINIPORT_DUMP_POINTERS (storport.h)
Un pilote miniport Storport utilise cette structure pour prendre en charge le code de fonction SCSI_REQUEST_BLOCK (SRB) SRB_FUNCTION_DUMP_POINTERS. Lorsqu’un pilote miniport reçoit ce type de SRB, le DataBuffer membre SRB pointe vers une structure de MINIPORT_DUMP_POINTERS. Ce SRB est envoyé au pilote miniport utilisé pour contrôler le disque qui contient les données de vidage sur incident après que le SRB a été retourné à partir du du pilote miniport HwStorInitialize routine. Les pilotes miniport virtuels sont nécessaires pour prendre en charge SRB_FUNCTION_DUMP_POINTERS.
Syntaxe
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;
Membres
Version
Défini sur DUMP_MINIPORT_VERSION_1.
Size
Défini sur sizeof(MINIPORT_DUMP_POINTERS).
DriverName[DUMP_MINIPORT_NAME_LENGTH]
Nom de caractère large du pilote miniport sans informations de chemin d’accès (par exemple, Miniport.sys).
AdapterObject
Défini sur NULL .
MappedRegisterBase
Défini sur zéro.
CommonBufferSize
Taille de la mémoire tampon commune requise. La taille ne doit pas dépasser 64 Ko (65 536 octets).
MiniportPrivateDumpData
Contexte à passer à la routine HwStorFindAdapter du pilote miniport lors de la vidage sur incident. Le contexte est transmis dans le membre réservé ou, à partir de Windows 8, le membre MiniportDumpData de la structure PORT_CONFIGURATION_INFORMATION.
SystemIoBusNumber
Spécifie le numéro attribué par le système du bus d’E/S auquel l’adaptateur HBA est connecté. Le pilote Storport initialise ce membre. Les pilotes Miniport qui fonctionnent avec le pilote Storport ne doivent pas modifier ce membre. Pour plus d’informations, consultez le SystemIoBusNumber membre de PORT_CONFIGURATION_INFORMATION.
AdapterInterfaceType
Identifie l’interface de bus d’E/S. Le pilote Storport initialise ce membre. Les pilotes Miniport qui fonctionnent avec le pilote Storport ne doivent pas modifier ce membre. Pour plus d’informations, consultez le membre AdapterInterfaceType de PORT_CONFIGURATION_INFORMATION.
MaximumTransferLength
Spécifie le nombre maximal d’octets que l’adaptateur HBA peut transférer dans une seule opération de transfert en mode crashdump. Par défaut, la valeur de ce membre est SP_UNINITIALIZED_VALUE, ce qui indique une taille de transfert maximale illimitée. Cette valeur est spécifique à l’opération de vidage du miniport et peut différer de la valeur dans le membre MaximumTransferLength de PORT_CONFIGURATION_INFORMATION.
NumberOfPhysicalBreaks
Spécifie le nombre maximal d’interruptions entre les plages d’adresses qu’une mémoire tampon de données peut avoir à créer des listes de nuages de points/de collecte. En d’autres termes, le nombre d’entrées de liste de nuages/de collecte que l’adaptateur peut prendre en charge moins un. Pour plus d’informations, consultez le membre NumberOfPhysicalBreaks de PORT_CONFIGURATION_INFORMATION.
AlignmentMask
Contient un masque qui indique les restrictions d’alignement des mémoires tampons requises par l’adaptateur HBA pour les opérations de transfert. Les valeurs de masque valides sont également limitées par les caractéristiques des gestionnaires de mémoire sur différentes versions des systèmes d’exploitation Microsoft Windows. Les valeurs de masque valides sont 0 (alignées sur des octets), 0x1 (alignés sur les mots), 0x3 (aligné sur DWORD) et 0x7 (double DWORD aligné). Le pilote miniport doit définir ce masque si l’adaptateur HBA prend en charge le nuage de points/collecte. Les mêmes considérations s’appliquent au membre AlignmentMask de PORT_CONFIGURATION_INFORMATION.
NumberOfAccessRanges
Spécifie le nombre d’éléments AccessRanges dans le tableau. Pour plus d’informations, consultez le NumberOfAccessRanges membre de PORT_CONFIGURATION_INFORMATION.
AccessRanges
Pointeur vers un tableau d’éléments de type ACCESS_RANGE. Le pilote Storport initialise ce membre. Les pilotes Miniport qui fonctionnent avec le pilote Storport ne doivent pas modifier ce membre. Pour plus d’informations, consultez le membre AccessRanges de PORT_CONFIGURATION_INFORMATION.
NumberOfBuses
Spécifie le nombre d’autobus contrôlés par l’adaptateur. Par défaut, la valeur de ce membre est égale à zéro. Pour plus d’informations, consultez le NumberOfBuses membre de PORT_CONFIGURATION_INFORMATION.
Master
Indique, quand TRUE, que l’adaptateur HBA est un maître de bus. Le pilote Storport initialise ce membre pour TRUE, car ses pilotes miniports doivent prendre en charge DMA de mastering bus. Les pilotes Miniport qui fonctionnent avec le pilote Storport ne doivent pas modifier cette valeur. Pour plus d’informations, consultez le membre Master de PORT_CONFIGURATION_INFORMATION.
MapBuffers
Indique si le pilote Storport mappe les adresses de mémoire tampon de données SRB aux adresses virtuelles système. Pour plus d’informations, consultez les MapBuffers membre de HW_INITIALIZATION_DATA.
MaximumNumberOfTargets
Spécifie le nombre de périphériques cibles que l’adaptateur peut contrôler. Pour plus d’informations, consultez le MaximumNumberOfTargets membre de PORT_CONFIGURATION_INFORMATION.
Remarques
À compter de Windows 8, les pilotes miniport physiques peuvent éventuellement prendre en charge SRB_FUNCTION_DUMP_POINTERS. Si un miniport physique prend en charge cette fonction, il doit définir l’indicateur STOR_FEATURE_DUMP_POINTERS dans le membre FeatureSupport de la structure HW_INITIALIZATION_DATA avant d’appeler StorPortInitialize. Les miniports physiques sont nécessaires pour définir au moins les version et les membres Size de MINIPORT_DUMP_POINTERS. En outre, si elle diffère de la valeur donnée dans PORT_CONFIGURATION_INFORMATION, le membre MaximumTransferLength est requis pour un miniport physique.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | storport.h (include Storport.h) |