struktur PORT_CONFIGURATION_INFORMATION (storport.h)

Artikel
08/07/2023

PORT_CONFIGURATION_INFORMATION berisi informasi konfigurasi untuk adaptor bus host (HBA).

Sintaks

typedef struct _PORT_CONFIGURATION_INFORMATION {
  ULONG                                  Length;
  ULONG                                  SystemIoBusNumber;
  INTERFACE_TYPE                         AdapterInterfaceType;
  ULONG                                  BusInterruptLevel;
  ULONG                                  BusInterruptVector;
  KINTERRUPT_MODE                        InterruptMode;
  ULONG                                  MaximumTransferLength;
  ULONG                                  NumberOfPhysicalBreaks;
  ULONG                                  DmaChannel;
  ULONG                                  DmaPort;
  DMA_WIDTH                              DmaWidth;
  DMA_SPEED                              DmaSpeed;
  ULONG                                  AlignmentMask;
  ULONG                                  NumberOfAccessRanges;
  ACCESS_RANGE( )                          *AccessRanges[];
  PVOID                                  MiniportDumpData;
  PVOID                                  Reserved;
  UCHAR                                  NumberOfBuses;
  CCHAR                                  InitiatorBusId[8];
  BOOLEAN                                ScatterGather;
  BOOLEAN                                Master;
  BOOLEAN                                CachesData;
  BOOLEAN                                AdapterScansDown;
  BOOLEAN                                AtdiskPrimaryClaimed;
  BOOLEAN                                AtdiskSecondaryClaimed;
  BOOLEAN                                Dma32BitAddresses;
  BOOLEAN                                DemandMode;
  UCHAR                                  MapBuffers;
  BOOLEAN                                NeedPhysicalAddresses;
  BOOLEAN                                TaggedQueuing;
  BOOLEAN                                AutoRequestSense;
  BOOLEAN                                MultipleRequestPerLu;
  BOOLEAN                                ReceiveEvent;
  BOOLEAN                                RealModeInitialized;
  BOOLEAN                                BufferAccessScsiPortControlled;
  UCHAR                                  MaximumNumberOfTargets;
  UCHAR                                  SrbType;
  UCHAR                                  AddressType;
  UCHAR                                  ReservedUchars[2];
  ULONG                                  SlotNumber;
  ULONG                                  BusInterruptLevel2;
  ULONG                                  BusInterruptVector2;
  KINTERRUPT_MODE                        InterruptMode2;
  ULONG                                  DmaChannel2;
  ULONG                                  DmaPort2;
  DMA_WIDTH                              DmaWidth2;
  DMA_SPEED                              DmaSpeed2;
  ULONG                                  DeviceExtensionSize;
  ULONG                                  SpecificLuExtensionSize;
  ULONG                                  SrbExtensionSize;
  UCHAR                                  Dma64BitAddresses;
  BOOLEAN                                ResetTargetSupported;
  UCHAR                                  MaximumNumberOfLogicalUnits;
  BOOLEAN                                WmiDataProvider;
  STOR_SYNCHRONIZATION_MODEL             SynchronizationModel;
  PHW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE HwMSInterruptRoutine;
  INTERRUPT_SYNCHRONIZATION_MODE         InterruptSynchronizationMode;
  MEMORY_REGION                          DumpRegion;
  ULONG                                  RequestedDumpBufferSize;
  BOOLEAN                                VirtualDevice;
  UCHAR                                  DumpMode;
  UCHAR                                  DmaAddressWidth;
  ULONG                                  ExtendedFlags1;
  ULONG                                  MaxNumberOfIO;
  ULONG                                  MaxIOsPerLun;
  ULONG                                  InitialLunQueueDepth;
  ULONG                                  BusResetHoldTime;
  ULONG                                  FeatureSupport;
} PORT_CONFIGURATION_INFORMATION, *PPORT_CONFIGURATION_INFORMATION;

Anggota

Length

Ukuran, dalam byte, dari struktur PORT_CONFIGURATION_INFORMATION . Diinisialisasi oleh driver Storport, anggota ini juga berfungsi sebagai versi struktur.

SystemIoBusNumber

Nomor bus I/O yang ditetapkan sistem tempat HBA terhubung. Driver miniport tidak boleh mengubah anggota ini. Nilainya ditetapkan sistem karena platform mungkin memiliki beberapa bus I/O dari AdapterInterfaceType yang ditentukan.

AdapterInterfaceType

Antarmuka bus I/O. Storport menginisialisasi anggota ini ke nilai yang ditentukan oleh driver miniport dalam struktur HW_INITIALIZATION_DATA . Driver miniport tidak boleh mengubah anggota ini.

BusInterruptLevel

Tingkat permintaan interupsi relatif bus. Storport tidak membuat asumsi tentang penggunaan interupsi HBA, sehingga nilai defaultnya adalah nol. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

BusInterruptVector

Vektor relatif bus dikembalikan oleh HBA. Storport tidak membuat asumsi tentang penggunaan interupsi HBA, sehingga nilai defaultnya adalah nol. Anggota ini tidak relevan dengan pengemudi yang menyiapkan anggota BusInterruptLevel untuk HBA mereka. Hal ini berkaitan dengan HBA pada jenis bus I/O yang menggunakan vektor interupsi, seperti PCIBus. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

InterruptMode

Menentukan apakah HBA menggunakan interupsi LevelSensitive atau Latched (terkadang disebut "edge-triggered"). Storport menginisialisasi anggota ini ke nilai yang sesuai untuk bus dan perangkat--misalnya, LevelSensitive untuk PCIBus. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

MaximumTransferLength

Jumlah maksimum byte yang dapat ditransfer HBA dalam satu operasi transfer. Secara default, nilai anggota ini adalah SP_UNINITIALIZED_VALUE, yang menunjukkan ukuran transfer maksimum tak terbatas. Jika HBA-nya memiliki dukungan transfer yang lebih terbatas, driver miniport harus mengatur ulang anggota ini sesuai dengan kapasitas transfer HBA. Jika rutinitas HwStorInterrupt driver miniport tidak dapat menonaktifkan gangguan pada HBA, anggota ini dapat disesuaikan selama pengembangan driver untuk memastikan bahwa waktu yang dihabiskan dalam ISR driver miniport tidak menurunkan performa sistem secara keseluruhan.

NumberOfPhysicalBreaks

Jumlah maksimum halaman fisik yang dapat dikelola adaptor penyimpanan dalam satu transfer (dengan kata lain, sejauh dukungannya menyebar/mengumpulkan). Secara default, nilai anggota ini adalah 0x11. Driver miniport harus mengatur ulang anggota ini sesuai dengan kemampuan adaptor penyimpanan.

DmaChannel

Saluran DMA yang digunakan oleh HBA bawahan. Secara default, nilai anggota ini SP_UNINITIALIZED_VALUE. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

DmaPort

Port DMA yang digunakan oleh HBA bawahan. Secara default, nilai anggota ini SP_UNINITIALIZED_VALUE. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

DmaWidth

Lebar transfer DMA jika HBA menggunakan DMA. Secara default, nilai anggota ini adalah nol. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

DmaSpeed

Kecepatan transfer data DMA untuk Eisa HBA. Storport menginisialisasi anggota ini dan driver miniport tidak boleh memodifikasinya.

AlignmentMask

Masker yang menunjukkan pembatasan perataan untuk buffer yang diperlukan oleh HBA untuk operasi transfer. Beberapa contoh nilai masker yang valid adalah 0 (byte aligned), 1 (word aligned), 3 (DWORD aligned) dan 7 (double DWORD aligned). Driver miniport harus mengatur masker ini jika HBA mendukung sebar/berkumpul. Nilai masker perataan yang diizinkan berikut didefinisikan dalam wdm.h:

Nilai	Makna
FILE_BYTE_ALIGNMENT (0x00000000)	Data diratakan byte (tidak ada persyaratan penyelarasan untuk perangkat)
FILE_WORD_ALIGNMENT (0x00000001)	Data harus diratakan pada batas 2 byte.
FILE_LONG_ALIGNMENT (0x00000003)	Data harus diratakan pada batas 4 byte.
FILE_QUAD_ALIGNMENT (0x00000007)	Data harus diratakan pada batas 8-byte.
FILE_OCTA_ALIGNMENT (0x0000000f)	Data harus diratakan pada batas 16 byte.
FILE_32_BYTE_ALIGNMENT (0x0000001f)	Data harus diratakan pada batas 32 byte.
FILE_64_BYTE_ALIGNMENT (0x0000003f)	Data harus diratakan pada batas 64 byte.
FILE_128_BYTE_ALIGNMENT (0x0000007f)	Data harus diratakan pada batas 128 byte.
FILE_256_BYTE_ALIGNMENT (0x000000ff)	Data harus diratakan pada batas 256 byte.
FILE_512_BYTE_ALIGNMENT (0x000001ff)	Data harus diratakan pada batas 512 byte.

NumberOfAccessRanges

Menentukan jumlah elemen AccessRanges dalam array.

AccessRanges

Arahkan ke array elemen jenis ACCESS_RANGE. Storport mengalokasikan memori untuk rentang akses dan menginisialisasi anggota ini. Driver miniport tidak boleh mengubah anggota ini.

MiniportDumpData

Penunjuk ke konteks cadangan yang digunakan selama crashdump atau hibernasi.

Reserved

Dicadangkan untuk penggunaan sistem (pra-Windows 8).

NumberOfBuses

Jumlah bus yang dikontrol oleh adaptor. Secara default, nilai anggota ini adalah nol. Anggota ini memiliki nilai maksimum SCSI_MAXIMUM_BUSES_PER_ADAPTER. Anggota ini tersedia mulai dari Windows 8.

InitiatorBusId[8]

ID bus inisiator. Jika input InitiatorBusId[0] memiliki nilai SP_UNINITIALIZED_VALUE, driver miniport dapat menetapkan nilai default jika HBA-nya tidak memerlukan penggunaan nilai tertentu yang ditentukan dengan mengkueri HBA. Jika tidak, driver miniport harus menggunakan nilai bukan nol yang ditetapkan oleh driver port jika memungkinkan. Biasanya, nilai ini dibatasi oleh nilai yang ditetapkan untuk MaximumNumberOfTargets.

ScatterGather

Ketika TRUE, HBA mendukung sebar/kumpulkan. Storport menginisialisasi anggota ini ke TRUE karena driver miniport-nya harus mendukung scatter/gather. Driver miniport yang bekerja dengan Storport tidak boleh memodifikasi nilai ini. (CATATAN: di versi Windows sebelum Windows Server 2008 R2 dan Windows 7, anggota ini diatur ke FALSE. Dalam hal ini, driver miniport harus mengatur anggota ini ke TRUE. Tidak mengatur anggota ini ke TRUE akan menyebabkan perangkat HBA gagal dimulai.)

Master

Jika TRUE, HBA adalah bus master. Storport menginisialisasi anggota ini ke TRUE karena driver miniport-nya harus mendukung DMA yang menguasai bus. Driver miniport yang bekerja dengan Storport tidak boleh memodifikasi nilai ini. (CATATAN: di versi Windows sebelum Windows Server 2008 R2 dan Windows 7, anggota ini diatur ke FALSE. Dalam hal ini, driver miniport harus mengatur anggota ini ke TRUE. Tidak mengatur anggota ini ke TRUE akan menyebabkan perangkat HBA gagal dimulai.)

CachesData

Saat TRUE, HBA menyimpan data atau mempertahankan status cache pada periferal. Ketika FALSE, HBA tidak menyimpan data atau mempertahankan status cache pada periferal. Secara default, nilai anggota ini adalah FALSE. Jika ini diatur ulang ke TRUE, Storport memberi tahu driver miniport ketika peristiwa sistem tertentu terjadi, seperti flush cache sistem file.

AdapterScansDown

Storport mengabaikan anggota ini.

AtdiskPrimaryClaimed

Storport tidak menggunakan anggota ini, dan driver miniport-nya tidak boleh mengaturnya.

AtdiskSecondaryClaimed

Storport tidak menggunakan anggota ini, dan driver miniport-nya tidak boleh mengaturnya.

Dma32BitAddresses

Ketika TRUE, HBA memiliki 32 baris alamat dan dapat mengakses memori dengan alamat fisik yang lebih besar dari 0x00FFFFFF. Storport menginisialisasi anggota ini ke TRUE, karena driver miniport-nya harus mendukung DMA lebar bus. Driver Miniport tidak boleh mengubah nilai ini karena ini adalah alamat DMA default jika nilai untuk Dma64BitAddresses tidak diatur. CATATAN: Jika hanya alamat 32-bit yang didukung oleh perangkat keras perangkat, maka Dma64BitAddresses harus diatur ke 0.

DemandMode

Menunjukkan apakah pengontrol DMA sistem harus diprogram untuk mode permintaan daripada operasi siklus tunggal. Storport menginisialisasi anggota ini ke FALSE, karena tidak mendukung DMA mode subordinat. Driver Miniport tidak boleh mengubah nilai ini.

MapBuffers

Menunjukkan apakah Storport memetakan alamat buffer data SRB ke alamat virtual sistem. Driver miniport mengatur anggota ini ke salah satu nilai berikut untuk mengontrol pemetaan untuk alamat buffer data SRB.

Nilai	Makna
STOR_MAP_NO_BUFFERS	Memetakan buffer hanya untuk SRB_FUNCTION_IO_CONTROL dan SRB_FUNCTION_WMI.
STOR_MAP_ALL_BUFFERS	Kedaluwarsa. Nilai ini memiliki efek yang sama dengan STOR_MAP_NON_READ_WRITE_BUFFERS.
STOR_MAP_NON_READ_WRITE_BUFFERS	Memetakan buffer untuk semua IO kecuali untuk permintaan baca dan tulis.
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE	Memetakan buffer untuk semua IO termasuk permintaan baca dan tulis. Miniports mendukung boot harus menangani permintaan baca atau tulis PAGE_SIZE panjangnya. Permintaan baca atau tulis ini harus selalu berhasil diselesaikan. Storport mungkin gagal memetakan buffer dalam kondisi memori sistem yang rendah. Dalam hal ini, anggota DataBuffer di SRB akan menjadi NULL.

NeedPhysicalAddresses

Ketika TRUE, driver miniport harus menerjemahkan alamat virtual ke alamat fisik, seperti yang diperlukan oleh HBA. Storport menginisialisasi anggota ini ke TRUE, karena driver miniport-nya harus mendukung daftar sebar/kumpulkan. Miniport tidak boleh mengubah nilai ini.

TaggedQueuing

Ketika TRUE, HBA mendukung antrean beberapa permintaan dengan tag SCSI. Storport menginisialisasi anggota ini ke TRUE karena driver miniport-nya harus mendukung tagged-queuing. Driver Miniport tidak boleh mengubah nilai ini.

AutoRequestSense

Ketika TRUE, HBA mendukung pengertian permintaan otomatis. Storport menginisialisasi anggota ini ke TRUE karena driver miniport-nya harus mendukung pengertian permintaan otomatis. Driver Miniport tidak boleh mengubah nilai ini.

MultipleRequestPerLu

Ketika TRUE, HBA mendukung beberapa permintaan per unit logis. Storport menginisialisasi anggota ini ke TRUE karena driver miniport-nya harus mendukung beberapa permintaan yang dikeluarkan ke unit logis pada saat itu. Driver Miniport tidak boleh mengubah nilai ini.

ReceiveEvent

Storport tidak menggunakan anggota ini, dan driver miniport-nya tidak boleh mengaturnya.

RealModeInitialized

Storport tidak menggunakan anggota ini, dan driver miniport-nya tidak boleh mengaturnya.

BufferAccessScsiPortControlled

Storport tidak menggunakan anggota ini, dan driver miniport-nya tidak boleh mengaturnya.

MaximumNumberOfTargets

Jumlah periferal target yang dapat dikontrol adaptor. Secara default, nilai anggota ini adalah SCSI_MAXIMUM_TARGETS_PER_BUS. Driver miniport dapat mengatur ulang anggota ini ke nilai yang lebih rendah jika HBA memiliki kemampuan yang lebih terbatas atau ke nilai yang lebih besar, menunjukkan bahwa HBA memiliki kemampuan bus yang diperluas. Nilai maksimum untuk anggota ini adalah 255.

SrbType

Jenis SRB yang akan dikirim ke driver miniport. Tersedia mulai dari Windows 8. Ini diatur ke salah satu nilai berikut:

Nilai	Makna
SRB_TYPE_SCSI_REQUEST_BLOCK	Driver miniport menerima SRB standar.
SRB_TYPE_STORAGE_REQUEST_BLOCK	Driver miniport menerima SRB yang diperluas.

AddressType

Jenis alamat yang digunakan antara Storport dan driver miniport. Tersedia mulai dari Windows 8. Ini dapat diatur ke nilai berikut:

Nilai	Makna
STORAGE_ADDRESS_TYPE_BTL8	Alamat 8-bit Bus, Target, dan LUN (BTL).

ReservedUchars[2]

Dicadangkan untuk penggunaan sistem (pra-Windows 8).

SlotNumber