structure MINIPORT_DUMP_POINTERS (storport.h)
Un pilote de miniport Storport utilise cette structure pour prendre en charge le code de la fonction SCSI_REQUEST_BLOCK (SRB) SRB_FUNCTION_DUMP_POINTERS. Lorsqu’un pilote miniport reçoit ce type de SRB, le membre DataBuffer SRB pointe vers une structure MINIPORT_DUMP_POINTERS . Ce SRB est envoyé au pilote miniport qui est utilisé pour contrôler le disque qui contient les données de vidage sur incident après que le SRB a été retourné à partir de la routine HwStorInitialize du pilote miniport. 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éfinissez sur DUMP_MINIPORT_VERSION_1.
Size
Définissez 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éfinit la valeur zéro.
CommonBufferSize
Taille de la mémoire tampon commune requise. La taille ne doit pas être supérieure à 64 Ko (65 536 octets).
MiniportPrivateDumpData
Contexte à passer à la routine HwStorFindAdapter du pilote miniport pendant le vidage sur incident. Le contexte est passé dans le membre réservé ou, à compter 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 membre SystemIoBusNumber 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 du 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 pour créer des listes de points/regroupements. En d’autres termes, le nombre d’entrées de liste de points/regroupements 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 pour les 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 (octet aligné), 0x1 (mot aligné), 0x3 (DWORD aligné) et 0x7 (double d’alignement DWORD). Le pilote miniport doit définir ce masque si l’adaptateur HBA prend en charge la diffusion/la 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 membre NumberOfAccessRanges 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 de bus contrôlés par l’adaptateur. Par défaut, la valeur de ce membre est zéro. Pour plus d’informations, consultez le membre NumberOfBuses de PORT_CONFIGURATION_INFORMATION.
Master
Indique, quand TRUE, que l’adaptateur HBA est un master de bus. Le pilote Storport initialise ce membre en TRUE, car ses pilotes miniports doivent prendre en charge la gestion DMA de gestion des bus. Les pilotes miniport qui fonctionnent avec le pilote Storport ne doivent pas modifier cette valeur. Pour plus d’informations, consultez le membre Maître 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 le membre MapBuffers 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 membre MaximumNumberOfTargets de PORT_CONFIGURATION_INFORMATION.
Remarques
À compter de Windows 8, les pilotes minport 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. Des miniports physiques sont nécessaires pour définir au moins les membres Version et Taille de MINIPORT_DUMP_POINTERS. En outre, s’il diffère de la valeur donnée dans PORT_CONFIGURATION_INFORMATION, le membre MaximumTransferLength est requis pour un miniport physique.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | storport.h (inclure Storport.h) |