storport.h) (結構MINIPORT_DUMP_POINTERS
Storport 迷你埠驅動程式會使用此結構來支援 SCSI_REQUEST_BLOCK ( SRB) 函式程式碼SRB_FUNCTION_DUMP_POINTERS。 當迷你埠驅動程式收到這類 SRB 時， DataBuffer SRB 成員會指向 MINIPORT_DUMP_POINTERS 結構。 此 SRB 會傳送至迷你埠驅動程式，用來控制從迷你埠驅動程式 的 HwStorInitialize 例程傳回 SRB 之後保存損毀傾印數據的磁碟。 需要虛擬迷你埠驅動程式才能支援SRB_FUNCTION_DUMP_POINTERS。
語法
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;
成員
Version
設定為 DUMP_MINIPORT_VERSION_1。
Size
設定為sizeof (MINIPORT_DUMP_POINTERS) 。
DriverName[DUMP_MINIPORT_NAME_LENGTH]
迷你埠驅動程式的寬字元名稱，例如路徑資訊 (Miniport.sys) 。
AdapterObject
設定為 NULL。
MappedRegisterBase
設定為零。
CommonBufferSize
所需之一般緩衝區的大小。 大小不得大於 64 KB (65,536 個字節) 。
MiniportPrivateDumpData
要在損毀傾印期間傳遞至迷你埠驅動程式 HwStorFindAdapter 例程的內容。 內容會傳入保留成員，或從 Windows 8 開始，PORT_CONFIGURATION_INFORMATION 結構的MiniportDumpData成員。
SystemIoBusNumber
指定 HBA 所連線之 I/O 總線的系統指派號碼。 Storport 驅動程式會初始化這個成員。 使用 Storport 驅動程式的迷你埠驅動程式不得變更此成員。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION 的 SystemIoBusNumber 成員。
AdapterInterfaceType
識別 I/O 總線介面。 Storport 驅動程式會初始化這個成員。 使用 Storport 驅動程式的迷你埠驅動程式不得修改此成員。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION的 AdapterInterfaceType 成員。
MaximumTransferLength
指定 HBA 可以在當機傾印模式的單一傳輸作業中傳輸的最大位元元組數目。 根據預設，這個成員的值是SP_UNINITIALIZED_VALUE，這表示傳輸大小上限無限制。 此值專屬於迷你埠的傾印作業，而且可能與 PORT_CONFIGURATION_INFORMATION的 MaximumTransferLength 成員中的值不同。
NumberOfPhysicalBreaks
指定數據緩衝區必須建立散佈/收集清單的位址範圍之間的中斷數目上限。 換句話說，配接器可支援的散佈/收集清單項目數目減一。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION的 NumberOfPhysicalBreaks 成員。
AlignmentMask
包含遮罩，表示 HBA 用於傳輸作業所需之緩衝區的對齊限制。 有效的遮罩值也會受限於不同版本的 Microsoft Windows 作業系統上的記憶體管理員特性。 有效的遮罩值為 0 (位元組對齊) 、0x1 (字组对齐) 、0x3 (DWORD 對齊) ，以及0x7 (双 DWORD 對齊) 。 如果 HBA 支援散佈/收集，迷你埠驅動程式應該設定此遮罩。 相同的考慮適用於 PORT_CONFIGURATION_INFORMATION的 AlignmentMask 成員。
NumberOfAccessRanges
指定陣列中的 AccessRanges 元素數目。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION的 NumberOfAccessRanges 成員。
AccessRanges
ACCESS_RANGE類型項目陣列的指標。 Storport 驅動程式會初始化這個成員。 使用 Storport 驅動程式的迷你埠驅動程式不得變更此成員。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION的 AccessRanges 成員。
NumberOfBuses
指定配接器所控制的總線數目。 根據預設，這個成員的值是零。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION 的 NumberOfBuses 成員。
Master
表示 HBA 是總線主機，當 為 TRUE 時。 Storport 驅動程式會將此成員初始化為 TRUE，因為其迷你埠驅動程式必須支援總線主控 DMA。 使用 Storport 驅動程式的迷你埠驅動程式不得變更此值。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION的主要成員。
MapBuffers
指出 Storport 驅動程式是否會將 SRB 數據緩衝區地址對應至系統虛擬位址。 如需詳細資訊，請參閱 HW_INITIALIZATION_DATA 的 MapBuffers 成員。
MaximumNumberOfTargets
指定配接器可以控制的目標周邊數目。 如需詳細資訊，請參閱 PORT_CONFIGURATION_INFORMATION 的 MaximumNumberOfTargets 成員。
備註
從 Windows 8 開始，實體minport驅動程式可以選擇性地支援SRB_FUNCTION_DUMP_POINTERS。 如果實體迷你埠支援此函式，它必須先在HW_INITIALIZATION_DATA結構的 FeatureSupport 成員中設定 STOR_FEATURE_DUMP_POINTERS 旗標，才能呼叫 StorPortInitialize。 必須有實體迷你埠，才能至少設定MINIPORT_DUMP_POINTERS的 Version 和 Size 成員。 此外，如果與 PORT_CONFIGURATION_INFORMATION中指定的值不同，實體迷你埠需要 MaximumTransferLength 成員。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | storport.h (包含 Storport.h) |