Fungsi ScsiPortGetLogicalUnit (srb.h)

Artikel
08/07/2023

Rutinitas ScsiPortGetLogicalUnit mengembalikan pointer ke area penyimpanan per LU driver miniport untuk periferal tertentu.

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 PVOID ScsiPortGetLogicalUnit(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses HBA yang dipetakan. Area ini tersedia untuk driver miniport di deviceExtension-HwDeviceExtension> anggota objek perangkat HBA segera setelah driver miniport memanggil ScsiPortInitialize. Driver port membebaskan memori ini ketika melepas perangkat.

[in] PathId

Mengidentifikasi bus SCSI.

[in] TargetId

Mengidentifikasi pengontrol target atau perangkat di bus.

[in] Lun

Mengidentifikasi nomor unit logis perangkat target.

Nilai kembali

ScsiPortGetLogicalUnit mengembalikan pointer ke area penyimpanan driver miniport untuk unit logis yang diminta. Jika driver port khusus sistem operasi menganggap unit logis ini tidak ada, driver tersebut mengembalikan NULL.

Keterangan

ScsiPortGetLogicalUnit tidak relevan jika rutinitas DriverEntry driver miniport menentukan nol untuk LuExtensionSize di HW_INITIALIZATION_DATA ketika disebut ScsiPortInitialize. Jika tidak, driver port khusus sistem operasi mengalokasikan dan menginisialisasi dengan nol satu set ekstensi LU dengan ukuran yang ditentukan untuk digunakan driver miniport.

Penyimpanan per LU dapat digunakan untuk menyimpan data yang relevan dengan periferal tertentu, seperti penunjuk data yang disimpan. Untuk mengakses area ini, driver miniport memanggil ScsiPortGetLogicalUnit ketika driver mempertahankan informasi tentang status atau operasi saat ini untuk periferal tertentu.

Driver port khusus sistem operasi dapat menganggap unit logis tidak ada jika tidak ada permintaan aktif untuk unit logis tersebut dan perangkat belum pernah berhasil dipilih.