structure MINIPORT_DUMP_POINTERS (storport.h)

Article
02/29/2024

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.