Fungsi ScsiPortInitialize (srb.h)

  • Artikel

Untuk driver miniport non-Plug and Play, rutinitas ScsiPortInitialize menyiapkan struktur PORT_CONFIGURATION_INFORMATION dan memanggil rutinitas HwScsiFindAdapter driver miniport. ScsiPortInitialize juga menyiapkan objek sistem dan sumber daya atas nama driver miniport. Untuk driver miniport Plug and Play, ScsiPortInitialize menyimpan data inisialisasi driver miniport untuk digunakan di masa mendatang.

Catatan Driver port SCSI dan model driver miniport SCSI dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, sebaiknya gunakan driver Storport dan model driver miniport Storport .
 

Sintaks

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Parameter

[in] Argument1

Arahkan ke objek driver yang diteruskan sistem operasi ke driver miniport dalam argumen pertama dari rutinitas DriverEntry-nya .

[in] Argument2

Arahkan ke beberapa informasi konteks bahwa sistem operasi diteruskan ke driver miniport dalam argumen kedua driverEntry-nya.

[in] HwInitializationData

Arahkan ke informasi inisialisasi dan konfigurasi yang disediakan oleh DriverEntry.

[in] HwContext

Menentukan alamat nilai konteks yang akan diteruskan ke rutinitas HwScsiFindAdapter driver miniport. Hanya driver miniport warisan yang memindai bus untuk HBA daripada menerima informasi konfigurasi dari driver port yang dapat menggunakan parameter ini untuk menyimpan status antara panggilan ke HwScsiFindAdapter.

Nilai kembali

ScsiPortInitialize mengembalikan nilai status yang digunakan sebagai nilai pengembalian dari rutinitas DriverEntry driver miniport.

Keterangan

Setiap rutinitas DriverEntry driver miniport harus memanggil ScsiPortInitialize setelah driver miniport pertama kali nol dan kemudian mengatur HW_INITIALIZATION_DATA.

Jika pengemudi miniport dapat mendukung HBA pada berbagai jenis bus I/O, seperti bus I/O jenis Isa dan MicroChannel , driver miniport harus memanggil ScsiPortInitialize untuk setiap jenis antarmuka yang didukung.

Driver miniport yang memanggil ScsiPortInitialize lebih dari sekali harus memeriksa nilai yang dikembalikan oleh ScsiPortInitialize di setiap panggilan dan menyimpan nilai terendah untuk semua panggilannya. Rutinitas DriverEntry harus mengembalikan nilai terendah ketika mengembalikan kontrol ke sistem. Penulis driver miniport tidak dapat membuat asumsi tentang nilai yang dikembalikan oleh ScsiPortInitialize.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header srb.h (termasuk Miniport.h, Scsi.h)
Pustaka Scsiport.lib

Lihat juga

DriverEntry dari SCSI Miniport Driver

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter