estrutura MINIPORT_DUMP_POINTERS (storport.h)
Um driver de miniporto storport usa essa estrutura para dar suporte ao código de função SRB (SCSI_REQUEST_BLOCK ) SRB_FUNCTION_DUMP_POINTERS. Quando um driver de miniporto recebe esse tipo de SRB, o membro SRB do DataBuffer aponta para uma estrutura MINIPORT_DUMP_POINTERS . Esse SRB é enviado para o driver de miniporto que é usado para controlar o disco que contém os dados de despejo de memória depois que o SRB foi retornado da rotina HwStorInitialize do driver de miniport. Os drivers de miniporta virtual são necessários para dar suporte a SRB_FUNCTION_DUMP_POINTERS.
Sintaxe
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;
Membros
Version
Defina como DUMP_MINIPORT_VERSION_1.
Size
Defina como sizeof(MINIPORT_DUMP_POINTERS).
DriverName[DUMP_MINIPORT_NAME_LENGTH]
O nome do caractere largo do driver de miniporte sem informações de caminho (por exemplo, Miniport.sys).
AdapterObject
Defina como NULL.
MappedRegisterBase
Defina como zero.
CommonBufferSize
O tamanho do buffer comum necessário. O tamanho não deve ser maior que 64 KB (65.536 bytes).
MiniportPrivateDumpData
O contexto que deve ser passado para a rotina HwStorFindAdapter do driver de miniport durante o despejo de memória. O contexto é passado no membro Reservado ou, começando com Windows 8, o membro MiniportDumpData da estrutura PORT_CONFIGURATION_INFORMATION.
SystemIoBusNumber
Especifica o número atribuído pelo sistema do barramento de E/S ao qual o HBA está conectado. O driver storport inicializa esse membro. Os drivers de miniport que funcionam com o driver Storport não devem alterar esse membro. Para obter mais informações, consulte o membro SystemIoBusNumber do PORT_CONFIGURATION_INFORMATION.
AdapterInterfaceType
Identifica a interface do barramento de E/S. O driver storport inicializa esse membro. Os drivers de miniport que funcionam com o driver Storport não devem modificar esse membro. Para obter mais informações, consulte o membro AdapterInterfaceType do PORT_CONFIGURATION_INFORMATION.
MaximumTransferLength
Especifica o número máximo de bytes que o HBA pode transferir em uma única operação de transferência no modo crashdump. Por padrão, o valor desse membro é SP_UNINITIALIZED_VALUE, o que indica um tamanho de transferência máximo ilimitado. Esse valor é específico para a operação de despejo do miniporto e pode ser diferente do valor no membro MaximumTransferLength de PORT_CONFIGURATION_INFORMATION.
NumberOfPhysicalBreaks
Especifica o número máximo de quebras entre intervalos de endereços que um buffer de dados pode ter para criar listas de dispersão/coleta. Em outras palavras, o número de entradas de lista de dispersão/coleta que o adaptador pode dar suporte a menos uma. Para obter mais informações, consulte o membro NumberOfPhysicalBreaks do PORT_CONFIGURATION_INFORMATION.
AlignmentMask
Contém uma máscara que indica as restrições de alinhamento para buffers exigidos pelo HBA para operações de transferência. Os valores de máscara válidos também são restritos por características dos gerenciadores de memória em diferentes versões dos sistemas operacionais Microsoft Windows. Os valores de máscara válidos são 0 (bytes alinhados), 0x1 (alinhado à palavra), 0x3 (DWORD alinhado) e 0x7 (DWORD duplo alinhado). O driver de miniporte deverá definir essa máscara se o HBA der suporte a dispersão/coleta. As mesmas considerações se aplicam ao membro AlignmentMask do PORT_CONFIGURATION_INFORMATION.
NumberOfAccessRanges
Especifica o número de elementos AccessRanges na matriz. Para obter mais informações, consulte o membro NumberOfAccessRanges do PORT_CONFIGURATION_INFORMATION.
AccessRanges
Um ponteiro para uma matriz de elementos do tipo ACCESS_RANGE. O driver storport inicializa esse membro. Os drivers de miniport que funcionam com o driver Storport não devem alterar esse membro. Para obter mais informações, consulte o membro AccessRanges do PORT_CONFIGURATION_INFORMATION.
NumberOfBuses
Especifica o número de ônibus controlados pelo adaptador. Por padrão, o valor desse membro é zero. Para obter mais informações, consulte o membro NumberOfBuses do PORT_CONFIGURATION_INFORMATION.
Master
Indica, quando TRUE, que o HBA é um master de ônibus. O driver storport inicializa esse membro como TRUE, pois seus drivers de miniport devem dar suporte ao DMA de masterização de ônibus. Os drivers de miniport que funcionam com o driver Storport não devem alterar esse valor. Para obter mais informações, consulte o membro mestre do PORT_CONFIGURATION_INFORMATION.
MapBuffers
Indica se o driver storport mapeia endereços de buffer de dados SRB para endereços virtuais do sistema. Para obter mais informações, consulte o membro mapBuffers do HW_INITIALIZATION_DATA.
MaximumNumberOfTargets
Especifica o número de periféricos de destino que o adaptador pode controlar. Para obter mais informações, consulte o membro MaximumNumberOfTargets do PORT_CONFIGURATION_INFORMATION.
Comentários
Começando com Windows 8, os drivers de minport físicos podem, opcionalmente, dar suporte a SRB_FUNCTION_DUMP_POINTERS. Se um miniporto físico der suporte a essa função, ele deverá definir o sinalizador STOR_FEATURE_DUMP_POINTERS no membro FeatureSupport da estrutura HW_INITIALIZATION_DATA antes de chamar StorPortInitialize. Miniportos físicos são necessários para definir pelo menos os membros De versão e tamanho de MINIPORT_DUMP_POINTERS. Além disso, se diferente do valor fornecido em PORT_CONFIGURATION_INFORMATION, o membro MaximumTransferLength será necessário para um miniporto físico.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | storport.h (inclua Storport.h) |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de