struktur PORT_CONFIGURATION_INFORMATION (srb.h)

Artikel
08/07/2023

PORT_CONFIGURATION_INFORMATION (SCSI) berisi informasi konfigurasi untuk HBA. Driver port khusus OS mengalokasikan dan menginisialisasi struktur ini, memasok informasi konfigurasi khusus HBA sebanyak mungkin, dan meneruskan struktur ke rutinitas HwScsiFindAdapter driver miniport. Driver port mendapatkan beberapa informasi untuk struktur ini dari struktur HW_INITIALIZATION_DATA driver miniport. Rutinitas HwScsiFindAdapter driver miniport bertanggung jawab untuk menentukan apakah driver miniport dapat mendukung HBA dan, jika demikian, untuk mengisi informasi yang tersisa yang bersangkutan dalam struktur PORT_CONFIGURATION_INFORMATION.

Catatan

Driver port SCSI dan model driver miniport SCSI dapat diubah atau tidak tersedia di masa mendatang. Gunakan driver Storport dan model driver miniport Storport sebagai gantinya.

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           Reserved;
  UCHAR           NumberOfBuses;
  UCHAR           InitiatorBusId[8];
  BOOLEAN         ScatterGather;
  BOOLEAN         Master;
  BOOLEAN         CachesData;
  BOOLEAN         AdapterScansDown;
  BOOLEAN         AtdiskPrimaryClaimed;
  BOOLEAN         AtdiskSecondaryClaimed;
  BOOLEAN         Dma32BitAddresses;
  BOOLEAN         DemandMode;
  BOOLEAN         MapBuffers;
  BOOLEAN         NeedPhysicalAddresses;
  BOOLEAN         TaggedQueuing;
  BOOLEAN         AutoRequestSense;
  BOOLEAN         MultipleRequestPerLu;
  BOOLEAN         ReceiveEvent;
  BOOLEAN         RealModeInitialized;
  BOOLEAN         BufferAccessScsiPortControlled;
  UCHAR           MaximumNumberOfTargets;
  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;
} PORT_CONFIGURATION_INFORMATION, *PPORT_CONFIGURATION_INFORMATION;

Anggota

Length

Menentukan ukuran struktur ini dalam byte. Akibatnya, anggota ini, yang selalu diinisialisasi oleh driver port khusus OS, menunjukkan versi struktur ini yang digunakan oleh driver port.

SystemIoBusNumber

Menentukan nomor bus I/O yang ditetapkan sistem tempat HBA terhubung. Driver port khusus OS selalu menginisialisasi anggota ini. Nilainya ditetapkan sistem karena platform mungkin memiliki beberapa bus I/O dari AdapterInterfaceType yang diberikan.

AdapterInterfaceType

Mengidentifikasi antarmuka bus I/O. Driver port khusus OS selalu mengatur anggota ini ke nilai yang ditentukan oleh driver miniport dalam struktur HW_INITIALIZATION_DATA (SCSI).

BusInterruptLevel

Menentukan tingkat permintaan interupsi relatif bus. Driver port khusus OS tidak membuat asumsi tentang penggunaan interupsi HBA, sehingga nilai defaultnya adalah nol. Tergantung pada AdapterInterfaceType dan HBA yang diberikan, nilai yang ditetapkan untuk anggota ini dapat sesuai dengan IRQL untuk bus, seperti untuk bus jenis Isa dan MicroChannel . Driver HBA Eisa harus mengatur nilai ini ke IRQL relatif bus untuk HBA jika adaptor dikonfigurasi untuk gangguan sensitif tingkat.

BusInterruptVector

Menentukan vektor relatif bus yang dikembalikan oleh HBA. Driver port khusus OS 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.

InterruptMode

Menentukan apakah HBA menggunakan interupsi LevelSensitive atau Latched (terkadang disebut "edge-triggered"). Driver port khusus OS menginisialisasi anggota ini ke nilai yang sesuai untuk bus dan perangkat --misalnya, LevelSensitive untuk PCIBus. Driver Eisa HBA harus mengatur ulang nilai ini jika adaptor dikonfigurasi untuk gangguan sensitif tingkat, karena harus driver HBA pada bus I/O yang menggunakan gangguan sensitif tingkat, seperti bus jenis MicroChannel .

MaximumTransferLength

Menentukan 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 HwScsiInterrupt driver miniport tidak dapat menonaktifkan gangguan pada HBA, anggota ini dapat disesuaikan selama pengembangan driver untuk memastikan bahwa waktu yang dihabiskan di ISR driver miniport tidak menyebabkan mouse "melompat" atau throughput serial/paralel turun ke tingkat yang terlihat pengguna.

NumberOfPhysicalBreaks

Menentukan jumlah maksimum jeda antara rentang alamat yang dapat dimiliki buffer data jika HBA mendukung sebar/kumpulkan. Dengan kata lain, jumlah daftar sebar/kumpulkan dikurangi satu. Secara default, nilai anggota ini adalah SP_UNINITIALIZED_VALUE, yang menunjukkan HBA dapat mendukung jumlah diskontiguitas fisik yang tidak terbatas. Jika driver port menetapkan nilai untuk anggota ini, driver miniport dapat menyesuaikan nilai lebih rendah tetapi tidak lebih tinggi. Jika anggota ini SP_UNINITIALIZED_VALUE, driver miniport harus mengatur ulang anggota ini sesuai dengan kapasitas HBA yang tersebar/mengumpulkan, dengan nol tidak mewakili dukungan yang menyebar/mengumpulkan.

DmaChannel

Menentukan saluran DMA yang digunakan oleh HBA bawahan. Secara default, nilai anggota ini SP_UNINITIALIZED_VALUE. Jika HBA menggunakan pengontrol DMA sistem dan AdapterInterfaceType yang diberikan adalah nilai apa pun kecuali MicroChannel, driver miniport harus mengatur ulang anggota ini.

DmaPort

Menentukan port DMA yang digunakan oleh HBA subordinat. Secara default, nilai anggota ini SP_UNINITIALIZED_VALUE. Jika HBA menggunakan pengontrol DMA sistem dan AdapterInterfaceType yang diberikan adalah MicroChannel, driver miniport harus mengatur anggota ini.

DmaWidth

Menentukan lebar transfer DMA jika HBA menggunakan DMA. Secara default, nilai anggota ini adalah nol. Jika HBA-nya melakukan DMA, driver miniport harus mengatur ulang anggota ini ke salah satu hal berikut: Width8Bits, Width16Bits, atau Width32Bits.

DmaSpeed

Menentukan kecepatan transfer data DMA untuk Eisa HBA. Secara default, nilai anggota ini menentukan waktu kompatibilitas. Nilai yang dapat diterima untuk anggota ini adalah salah satu hal berikut: Kompatibel, TypeA, TypeB, atau TypeC.

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 versi Windows yang berbeda. Nilai masker yang diizinkan di bawah Windows 95 atau Windows 98 adalah 0 (byte meratakan), 1 (rata kata) atau 3 (DWORD diratakan). Di bawah Windows NT dan Windows 2000, nilai masker yang valid adalah 0 (byte diratakan), 1 (rata kata), 3 (DWORD diratakan) dan 7 (DWORD ganda diratakan). Driver miniport harus mengatur masker ini jika HBA mendukung sebar/berkumpul.

NumberOfAccessRanges

Menentukan jumlah elemen AccessRanges dalam array, yang dijelaskan berikutnya. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA ketika driver miniport yang disebut ScsiPortInitialize.

AccessRanges

Reserved

Dicadangkan untuk penggunaan sistem dan tidak tersedia untuk digunakan oleh driver miniport.

NumberOfBuses

Menentukan jumlah bus SCSI yang dikendalikan oleh HBA. Secara default, nilai anggota ini adalah nol.

InitiatorBusId[8]

Menunjukkan ID bus inisiator. Jika input InitiatorBusId[0] memiliki nilai nol, 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. Setiap driver miniport harus memperbarui spesifikasi InitiatorBusId agar sesuai dengan apa yang digunakan HBA-nya, jika perlu mengkueri HBA untuk menentukan nilai yang sesuai.

Driver miniport harus menetapkan entri untuk setiap bus SCSI yang didukung oleh HBA, seperti yang ditunjukkan oleh nilai NumberOfBuses.

ScatterGather

Menunjukkan kapan TRUE bahwa HBA mendukung sebar/kumpulkan. Ketika FALSE , HBA tidak mendukung sebar/kumpulkan. Secara default, nilai anggota ini adalah FALSE.

Master

Menunjukkan kapan TRUE bahwa HBA adalah master bus. Ketika FALSE, HBA bukan master bus. Secara default, nilai anggota ini adalah FALSE.

CachesData

Menunjukkan kapan TRUE bahwa 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, driver port khusus OS memberi tahu driver miniport ketika peristiwa sistem tertentu terjadi, seperti flush cache sistem file dan pematian sistem. Misalnya, jika pengontrol di bus mencerminkan dua disk, driver miniport biasanya akan mengatur anggota ini ke TRUE.

AdapterScansDown

Menunjukkan kapan TRUE bahwa BIOS untuk pemindaian HBA untuk target bus SCSI dari tujuh hingga nol. Ketika FALSE, BIOS untuk HBA mencari target bus SCSI, dimulai dengan ID nol dan memindai ke atas ke (tetapi tidak termasuk) MaximumTargetIds. Secara default, nilai AdapterScansDown adalah FALSE.

AtdiskPrimaryClaimed

Menunjukkan ketika TRUE bahwa rentang alamat disk utama "AT" (kompatibel dengan WD1003), 0x1F0 ke 0x1FF, telah diklaim dalam registri oleh driver lain untuk perangkatnya. Driver port khusus OS selalu menginisialisasi anggota ini. Jika nilai input anggota ini TRUE, driver miniport harus berasumsi bahwa driver yang sudah dimuat telah mengklaim rentang perangkat. Jika nilai input FALSE, driver miniport dapat mengklaim rentang alamat untuk HBA yang meniru pengontrol disk "AT" dan mengatur ulang anggota ini ke TRUE, sehingga mencegah akses ke rentang ini oleh driver disk "AT" atau driver miniport yang kemudian dimuat.

AtdiskSecondaryClaimed

Menunjukkan kapan TRUE bahwa rentang alamat disk AT sekunder, 0x170 ke 0x17F telah diklaim dalam registri oleh driver lain untuk perangkatnya. Ketika FALSE rentang alamat disk AT sekunder belum diklaim dalam registri oleh driver lain. Driver port khusus OS selalu menginisialisasi anggota ini. Driver miniport harus memperlakukan anggota ini seperti untuk AtdiskPrimaryClaimed.

Dma32BitAddresses

Menunjukkan kapan TRUE bahwa HBA memiliki 32 baris alamat dan dapat mengakses memori dengan alamat fisik yang lebih besar dari 0x00FFFFFF. Ketika FALSE , HBA memiliki sejumlah baris alamat DMA selain 32. Secara default, nilai anggota ini adalah FALSE. Jika driver miniport menetapkan Dma64BitAddresses, anggota ini harus FALSE.

DemandMode

Menunjukkan kapan TRUE bahwa pengontrol DMA sistem harus diprogram untuk mode permintaan daripada operasi siklus tunggal. Jika HBA bukan perangkat subordinat, anggota ini harus FALSE.

MapBuffers

Menunjukkan kapan TRUE bahwa buffer data harus dipetakan ke rentang alamat virtual sistem. Ketika FALSE , buffer data tidak harus dipetakan ke alamat virtual sistem. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya. Jika FALSE, driver miniport tidak boleh mengakses Srb.DataBuffer secara langsung.

NeedPhysicalAddresses

Menunjukkan kapan TRUE bahwa driver miniport harus menerjemahkan alamat virtual ke alamat fisik, seperti yang diperlukan oleh HBA. Ketika FALSE, driver miniport tidak harus menerjemahkan alamat virtual ke alamat fisik. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya.

TaggedQueuing

Menunjukkan kapan TRUE bahwa HBA mendukung antrean beberapa permintaan dengan tag SCSI. Ketika FALSE, HBA tidak mendukung antrean bertag SCSI. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya.

AutoRequestSense

Menunjukkan kapan TRUE bahwa HBA mendukung pengertian permintaan otomatis. Ketika FALSE , HBA tidak mendukung pengertian permintaan otomatis. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya. Anggota ini harus diatur ke TRUE sebelum pengemudi HBA master bus memanggil ScsiPortGetUncachedExtension.

MultipleRequestPerLu

Menunjukkan kapan TRUE bahwa HBA mendukung beberapa permintaan per unit logis. Ketika FALSE , HBA tidak mendukung beberapa permintaan per unit logis. Mekanisme di mana adaptor menyimpan cache permintaan ditentukan adaptor. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya.

ReceiveEvent

Menunjukkan kapan TRUE bahwa HBA mendukung operasi penerimaan peristiwa SCSI. Ketika FALSE , HBA tidak mendukung operasi penerimaan peristiwa SCSI. Driver port khusus OS selalu mengatur anggota ini ke nilai yang diteruskan dalam struktur HW_INITIALIZATION_DATA (SCSI) ketika driver miniport yang disebut ScsiPortInitialize. Driver miniport dapat mengatur ulang nilai ini untuk HBA tertentu yang dikontrolnya.

RealModeInitialized

Menunjukkan kapan TRUE bahwa driver mode nyata (x86-only) telah menginisialisasi HBA. Ketika FALSE , HBA sebelumnya belum diinisialisasi oleh driver mode nyata. Driver port yang bergantung pada OS selalu menginisialisasi anggota ini. Jika ini diatur ke TRUE, driver miniport tidak boleh menginisialisasi HBA-nya jika urutan inisialisasi driver identik dengan inisialisasi HBA mode nyata; tidak menginisialisasi ulang HBA dalam keadaan ini membuat beban driver miniport jauh lebih cepat. Nilai anggota ini tidak relevan dengan driver miniport apa pun yang selalu menginisialisasi HBA-nya saat berjalan dalam mode terlindungi pada platform berbasis x86 dan untuk semua driver miniport yang tidak relevan apakah mereka berjalan pada platform berbasis CISC atau RISC.

BufferAccessScsiPortControlled

Menunjukkan kapan TRUE bahwa driver miniport selalu memanggil ScsiPortXxx untuk mengakses buffer data dan/atau informasi request-sense dalam SRB, sehingga memungkinkan driver port khusus OS untuk mengoptimalkan pemrosesan permintaan I/O. Ketika FALSE driver miniport tidak perlu memanggil rutinitas ScsiPortXxx untuk mengakses buffer data atau informasi request-sense. Mengatur anggota ini ke FALSE dapat menurunkan performa I/O HBA. Rutinitas panggilan selain ScsiPortXxx membuat driver miniport tidak dapat didukung di seluruh sistem operasi Microsoft.

MaximumNumberOfTargets

Menentukan jumlah periferal target yang dapat dikontrol HBA. Secara default, nilai anggota ini SCSI_MAXIMUM_TARGETS, sesuai dengan standar SCSI. 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 WIDE-SCSI atau Fibre Channel. Nilai ini terbatas pada SCSI_MAXIMUM_TARGETS_PER_BUS.

ReservedUchars[2]