Fungsi StorPortValidateRange (storport.h)

Artikel
02/29/2024

Rutinitas StorPortValidateRange menentukan apakah rentang alamat I/O tertentu sedang digunakan oleh adaptor lain. Rutinitas ini usang di Windows NT 4.0 dan sistem operasi yang lebih baru.

Sintaks

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

Parameter

[in] HwDeviceExtension

Penunjuk 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 driver miniport memanggil StorPortInitialize. Pengandar porta membebaskan memori ini ketika melepas perangkat.

[in] BusType

Berisi nilai jenis STORAGE_BUS_TYPE yang menunjukkan jenis bus.

SystemIoBusNumber

Berisi bilangan bulat yang mengidentifikasi bus sistem.

[in] IoAddress

Berisi alamat awal rentang alamat yang akan divalidasi.

[in] NumberOfBytes

Berisi panjang dalam byte dari rentang alamat yang akan divalidasi.

[in] InIoSpace

Menunjukkan, ketika TRUE, rentang alamat berada di ruang I/O. Jika FALSE, alamat berada di ruang memori.

Nilai kembali

StorPortValidateRange mengembalikan TRUE jika rentang alamat tertentu tidak diklaim oleh driver lain. Rutinitas ini mengembalikan FALSE jika driver lain telah mengklaim rentang alamat.

Keterangan

Untuk kompatibilitas dengan versi Windows yang lebih lama, rutinitas ini selalu mengembalikan TRUE.

Driver Miniport diberikan rentang I/O yang valid di anggota AccessRanges dari struktur PORT_CONFIGURATION_INFORMATION ketika driver Storport memanggil rutinitas panggilan balik HwStorFindAdapter miniport.

StorPortValidateRange menggunakan STOR_PHYSICAL_ADDRESS untuk mewakili alamat relatif bus.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

Jenis STOR_PHYSICAL_ADDRESS adalah jenis data independen sistem operasi yang digunakan driver miniport Storport untuk mewakili alamat fisik atau alamat relatif bus.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
Pustaka	Storport.lib
Aturan kepatuhan DDI	StorPortDeprecated(storport)

Lihat juga

ScsiPortValidateRange

Bagikan melalui