Fungsi StorPortGetLogicalUnit (storport.h)

  • Artikel

Rutinitas StorPortGetLogicalUnit mengembalikan pointer ke area penyimpanan per unit logis driver miniport.

Sintaks

STORPORT_API PVOID StorPortGetLogicalUnit(
  [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 yang dipetakan untuk HBA. Area ini tersedia untuk driver miniport segera setelah rutinitas HwStorFindAdapter driver miniport dipanggil. Pengandar porta membebaskan memori ini ketika melepas perangkat.

[in] PathId

Mengidentifikasi bus SCSI.

[in] TargetId

Mengidentifikasi pengontrol target atau perangkat pada bus.

[in] Lun

Mengidentifikasi nomor unit logis (LU) dari perangkat target.

Nilai kembali

StorPortGetLogicalUnit mengembalikan pointer ke area penyimpanan driver miniport untuk unit logis yang diminta. Jika unit logika tidak ada, unit tersebut mengembalikan NULL.

Keterangan

StorPortGetLogicalUnit tidak relevan jika rutinitas DriverEntry driver miniport menentukan nol untuk LuExtensionSize dalam HW_INITIALIZATION_DATA ketika disebut StorPortInitialize. Jika tidak, driver port khusus sistem operasi mengalokasikan dan menginisialisasi dengan nol satu set ekstensi LU dari 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 StorPortGetLogicalUnit 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.

Catatan

Ketika driver miniport memanggil StorPortGetLogicalUnit di IRQL = DISPATCH_LEVEL, fungsi memperoleh kunci interupsi. Memanggil StorPortGetLogicalUnit terlalu sering pada tingkat IRQL ini berdampak pada performa dan skalabilitas driver miniport.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header storport.h (termasuk Storport.h)
Pustaka Storport.lib

Lihat juga

HW_INITIALIZATION_DATA

StorPortInitialize