estructura de MINIPORT_DUMP_POINTERS (storport.h)

Artículo
08/07/2023

Un controlador de miniport storport usa esta estructura para admitir el código de función SCSI_REQUEST_BLOCK (SRB) SRB_FUNCTION_DUMP_POINTERS. Cuando un controlador de minipuerto recibe este tipo de SRB, el miembro SRB dataBuffer apunta a una estructura de MINIPORT_DUMP_POINTERS . Este SRB se envía al controlador de minipuerto que se usa para controlar el disco que contiene los datos del volcado de memoria después de que se devuelva el SRB desde la rutina HwStorInitialize del controlador de miniporte. Los controladores de minipuerto virtual son necesarios para admitir SRB_FUNCTION_DUMP_POINTERS.

Sintaxis

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;

Miembros

Version

Establezca en DUMP_MINIPORT_VERSION_1.

Size

Establezca en sizeof(MINIPORT_DUMP_POINTERS).

DriverName[DUMP_MINIPORT_NAME_LENGTH]

Nombre de caracteres anchos del controlador de miniporte sin información de ruta de acceso (por ejemplo, Miniport.sys).

AdapterObject

Se establece en NULL.

MappedRegisterBase

Establecer en cero.

CommonBufferSize

Tamaño del búfer común necesario. El tamaño no debe ser mayor que 64 KB (65 536 bytes).

MiniportPrivateDumpData

Contexto que se va a pasar a la rutina HwStorFindAdapter del controlador de miniporte durante el volcado de memoria. El contexto se pasa en el miembro Reservado o, a partir de Windows 8, el miembro MiniportDumpData de la estructura PORT_CONFIGURATION_INFORMATION.

SystemIoBusNumber

Especifica el número asignado por el sistema del bus de E/S al que está conectado el HBA. El controlador storport inicializa este miembro. Los controladores de minipuerto que funcionan con el controlador storport no deben cambiar este miembro. Para obtener más información, vea el miembro SystemIoBusNumber de PORT_CONFIGURATION_INFORMATION.

AdapterInterfaceType

Identifica la interfaz del bus de E/S. El controlador storport inicializa este miembro. Los controladores de miniport que funcionan con el controlador storport no deben modificar este miembro. Para obtener más información, vea el miembro AdapterInterfaceType de PORT_CONFIGURATION_INFORMATION.

MaximumTransferLength

Especifica el número máximo de bytes que el HBA puede transferir en una sola operación de transferencia en modo crashdump. De forma predeterminada, el valor de este miembro es SP_UNINITIALIZED_VALUE, lo que indica un tamaño de transferencia máximo ilimitado. Este valor es específico de la operación de volcado de memoria del miniporte y puede diferir del valor del miembro MaximumTransferLength de PORT_CONFIGURATION_INFORMATION.

NumberOfPhysicalBreaks

Especifica el número máximo de saltos entre intervalos de direcciones que un búfer de datos puede tener para crear listas de dispersión y recopilación. En otras palabras, el número de entradas de lista de dispersión y recopilación que el adaptador puede admitir menos uno. Para obtener más información, vea el miembro NumberOfPhysicalBreaks de PORT_CONFIGURATION_INFORMATION.

AlignmentMask

Contiene una máscara que indica las restricciones de alineación de los búferes requeridos por el HBA para las operaciones de transferencia. Los valores de máscara válidos también están restringidos por características de los administradores de memoria en diferentes versiones de los sistemas operativos Microsoft Windows. Los valores de máscara válidos son 0 (alineados por bytes), 0x1 (alineados por palabras), 0x3 (alineados con DWORD) y 0x7 (doble DWORD alineado). El controlador de minipuerto debe establecer esta máscara si el HBA admite dispersión o recopilación. Las mismas consideraciones se aplican al miembro AlignmentMask de PORT_CONFIGURATION_INFORMATION.

NumberOfAccessRanges

Especifica el número de elementos AccessRanges de la matriz. Para obtener más información, vea el miembro NumberOfAccessRanges de PORT_CONFIGURATION_INFORMATION.

AccessRanges

Puntero a una matriz de elementos de tipo ACCESS_RANGE. El controlador storport inicializa este miembro. Los controladores de minipuerto que funcionan con el controlador storport no deben cambiar este miembro. Para obtener más información, consulte el miembro AccessRanges de PORT_CONFIGURATION_INFORMATION.

NumberOfBuses

Especifica el número de buses controlados por el adaptador. De forma predeterminada, el valor de este miembro es cero. Para obtener más información, vea el miembro NumberOfBuses de PORT_CONFIGURATION_INFORMATION.

Master

Indica, cuando es TRUE, que el HBA es un patrón de autobús. El controlador storport inicializa este miembro en TRUE, ya que sus controladores de minipuerto deben admitir la DMA de maestro de bus. Los controladores de miniport que funcionan con el controlador storport no deben cambiar este valor. Para obtener más información, consulte el miembro Maestro de PORT_CONFIGURATION_INFORMATION.

MapBuffers

Indica si el controlador de Storport asigna direcciones de búfer de datos SRB a direcciones virtuales del sistema. Para obtener más información, consulte el miembro MapBuffers de HW_INITIALIZATION_DATA.

MaximumNumberOfTargets

Especifica el número de periféricos de destino que el adaptador puede controlar. Para obtener más información, vea el miembro MaximumNumberOfTargets de PORT_CONFIGURATION_INFORMATION.

Comentarios

A partir de Windows 8, los controladores de minport físicos pueden admitir opcionalmente SRB_FUNCTION_DUMP_POINTERS. Si un miniport físico admite esta función, debe establecer la marca de STOR_FEATURE_DUMP_POINTERS en el miembro FeatureSupport de la estructura de HW_INITIALIZATION_DATA antes de llamar a StorPortInitialize. Se requieren miniportes físicos para establecer al menos los miembros Version y Size de MINIPORT_DUMP_POINTERS. Además, si es diferente del valor especificado en PORT_CONFIGURATION_INFORMATION, se requiere el miembro MaximumTransferLength para un miniporte físico.