struktur MINIPORT_DUMP_POINTERS (storport.h)
Driver miniport Storport menggunakan struktur ini untuk mendukung kode fungsi SCSI_REQUEST_BLOCK (SRB) SRB_FUNCTION_DUMP_POINTERS. Ketika driver miniport menerima SRB semacam ini, anggota SRB DataBuffer menunjuk ke struktur MINIPORT_DUMP_POINTERS . SRB ini dikirim ke driver miniport yang digunakan untuk mengontrol disk yang menyimpan data crash dump setelah SRB dikembalikan dari rutinitas HwStorInitialize driver miniport. Driver miniport virtual diperlukan untuk mendukung SRB_FUNCTION_DUMP_POINTERS.
Sintaks
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;
Anggota
Version
Atur ke DUMP_MINIPORT_VERSION_1.
Size
Atur ke sizeof(MINIPORT_DUMP_POINTERS).
DriverName[DUMP_MINIPORT_NAME_LENGTH]
Nama karakter lebar driver miniport tanpa informasi jalur (misalnya, Miniport.sys).
AdapterObject
Atur ke NULL.
MappedRegisterBase
Atur ke nol.
CommonBufferSize
Ukuran buffer umum yang diperlukan. Ukurannya tidak boleh lebih besar dari 64 KB (65.536 byte).
MiniportPrivateDumpData
Konteks yang akan diteruskan ke rutinitas HwStorFindAdapter pengemudi miniport selama crash dump. Konteks diteruskan di anggota Cadangan atau, dimulai dengan Windows 8, anggota MiniportDumpData dari struktur PORT_CONFIGURATION_INFORMATION.
SystemIoBusNumber
Menentukan nomor bus I/O yang ditetapkan sistem tempat HBA terhubung. Driver Storport menginisialisasi anggota ini. Driver Miniport yang bekerja dengan driver Storport tidak boleh mengubah anggota ini. Untuk informasi selengkapnya, lihat anggota SystemIoBusNumberdari PORT_CONFIGURATION_INFORMATION.
AdapterInterfaceType
Mengidentifikasi antarmuka bus I/O. Driver Storport menginisialisasi anggota ini. Driver Miniport yang bekerja dengan driver Storport tidak boleh memodifikasi anggota ini. Untuk informasi selengkapnya, lihat anggota AdapterInterfaceTypedari PORT_CONFIGURATION_INFORMATION.
MaximumTransferLength
Menentukan jumlah maksimum byte yang dapat ditransfer HBA dalam operasi transfer tunggal dalam mode crashdump. Secara default, nilai anggota ini adalah SP_UNINITIALIZED_VALUE, yang menunjukkan ukuran transfer maksimum tak terbatas. Nilai ini khusus untuk operasi cadangan miniport dan mungkin berbeda dari nilai di anggota MaximumTransferLengthdari PORT_CONFIGURATION_INFORMATION.
NumberOfPhysicalBreaks
Menentukan jumlah hentian maksimum di antara rentang alamat yang dapat dilakukan buffer data untuk membuat daftar sebar/kumpulkan. Dengan kata lain, jumlah entri daftar sebar/kumpulkan yang dapat didukung adaptor dikurangi satu. Untuk informasi selengkapnya, lihat anggota numberOfPhysicalBreaksdari PORT_CONFIGURATION_INFORMATION.
AlignmentMask
Berisi masker yang menunjukkan pembatasan penyelarasan untuk buffer yang diperlukan oleh HBA untuk operasi transfer. Nilai masker yang valid juga dibatasi oleh karakteristik manajer memori pada berbagai versi sistem operasi Microsoft Windows. Nilai masker yang valid adalah 0 (byte aligned), 0x1 (word aligned), 0x3 (DWORD aligned), dan 0x7 (double DWORD aligned). Driver miniport harus mengatur masker ini jika HBA mendukung sebar/berkumpul. Pertimbangan yang sama berlaku untuk anggota AlignmentMaskdari PORT_CONFIGURATION_INFORMATION.
NumberOfAccessRanges
Menentukan jumlah elemen AccessRanges dalam array. Untuk informasi selengkapnya, lihat anggota NumberOfAccessRangesdari PORT_CONFIGURATION_INFORMATION.
AccessRanges
Penunjuk ke array elemen jenis ACCESS_RANGE. Driver Storport menginisialisasi anggota ini. Driver Miniport yang bekerja dengan driver Storport tidak boleh mengubah anggota ini. Untuk informasi selengkapnya, lihat anggota AccessRangesdari PORT_CONFIGURATION_INFORMATION.
NumberOfBuses
Menentukan jumlah bus yang dikontrol oleh adaptor. Secara default, nilai anggota ini adalah nol. Untuk informasi selengkapnya, lihat anggota NumberOfBusesdari PORT_CONFIGURATION_INFORMATION.
Master
Menunjukkan, ketika TRUE, bahwa HBA adalah master bus. Driver Storport menginisialisasi anggota ini ke TRUE, karena driver miniport-nya harus mendukung DMA yang menguasai bus. Driver Miniport yang bekerja dengan driver Storport tidak boleh mengubah nilai ini. Untuk informasi selengkapnya, lihat anggota MasterPORT_CONFIGURATION_INFORMATION.
MapBuffers
Menunjukkan apakah driver Storport memetakan alamat buffer data SRB ke alamat virtual sistem. Untuk informasi selengkapnya, lihat anggota MapBuffersdari HW_INITIALIZATION_DATA.
MaximumNumberOfTargets
Menentukan jumlah periferal target yang dapat dikontrol oleh adaptor. Untuk informasi selengkapnya, lihat anggota PORT_CONFIGURATION_INFORMATION MaximumNumberOfTargets.
Keterangan
Dimulai dengan Windows 8, driver minport fisik dapat secara opsional mendukung SRB_FUNCTION_DUMP_POINTERS. Jika miniport fisik mendukung fungsi ini, itu harus mengatur bendera STOR_FEATURE_DUMP_POINTERS di anggota FeatureSupport dari struktur HW_INITIALIZATION_DATA sebelum memanggil StorPortInitialize. Miniport fisik diperlukan untuk mengatur setidaknya anggota Versi dan UkuranMINIPORT_DUMP_POINTERS. Selain itu, jika berbeda dari nilai yang diberikan dalam PORT_CONFIGURATION_INFORMATION, anggota MaximumTransferLength diperlukan untuk miniport fisik.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | storport.h (termasuk Storport.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk