Fungsi ScsiPortFreeDeviceBase (srb.h)

  • Artikel

Rutinitas ScsiPortFreeDeviceBase membebaskan berbagai alamat I/O perangkat atau ruang memori yang sebelumnya dipetakan ke ruang alamat sistem dengan ScsiPortGetDeviceBase.

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 VOID ScsiPortFreeDeviceBase(
  [in] PVOID HwDeviceExtension,
  [in] PVOID MappedAddress
);

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] MappedAddress

Arahkan ke alamat dasar rentang yang akan dibebaskan. Alamat ini harus sama dengan yang dikembalikan oleh ScsiPortGetDeviceBase.

Nilai kembali

Tidak ada

Keterangan

Jika rutinitas HwScsiFindAdapter driver miniport menentukan bahwa driver tidak memerlukan alamat dasar yang dipetakan tertentu untuk adaptor, itu harus melepaskan pemetaan dengan memanggil rutinitas ini. Misalnya, ketika driver miniport menentukan tidak ada HBA yang didukung pada bus I/O tertentu, itu harus memanggil ScsiPortFreeDeviceBase dengan setiap alamat yang dipetakan yang dikembalikan oleh ScsiPortGetDeviceBase, jika ada panggilan ke rutinitas ini dilakukan.

ScsiPortFreeDeviceBase hanya dapat dipanggil dari rutinitas HwScsiFindAdapter driver miniport. Panggilan dari rutinitas driver miniport lainnya akan mengakibatkan kegagalan sistem atau operasi yang salah untuk pemanggil.

Persyaratan

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

Lihat juga

HwScsiFindAdapter

ScsiPortGetDeviceBase