PHW_FIND_ADAPTER fungsi panggilan balik (srb.h)

  • Artikel

Prototipe PHW_FIND_ADAPTER mendeklarasikan rutinitas yang menggunakan konfigurasi yang disediakan untuk menentukan apakah HBA tertentu didukung dan, jika ya, untuk mengembalikan informasi konfigurasi tentang adaptor tersebut.

Sintaks

PHW_FIND_ADAPTER PhwFindAdapter;

ULONG PhwFindAdapter(
  [in]      PVOID DeviceExtension,
  [in]      PVOID HwContext,
  [in]      PVOID BusInformation,
  [in]      PCHAR ArgumentString,
  [in, out] PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  [out]     PBOOLEAN Again
)
{...}

Parameter

[in] DeviceExtension

Arahkan ke area penyimpanan per HBA driver miniport.

[in] HwContext

Anggota cadangan ketika digunakan oleh salah satu driver miniport pengemudi Storport. Dengan driver miniport SCSI, anggota ini menunjuk ke nilai konteks. Untuk deskripsi arti anggota ini untuk driver miniport SCSI, lihat HwScsiFindAdapter.

[in] BusInformation

Anggota cadangan ketika digunakan oleh salah satu driver miniport pengemudi Storport. Dengan driver miniport SCSI, anggota ini menunjuk ke informasi spesifik jenis bus yang telah dikumpulkan oleh driver port khusus OS. Untuk deskripsi lengkap tentang arti anggota ini untuk driver miniport SCSI, lihat HwScsiFindAdapter.

[in] ArgumentString

Anggota cadangan ketika digunakan oleh salah satu driver miniport pengemudi Storport. Dengan driver miniport SCSI, anggota ini menunjuk ke string ASCII yang dihentikan null yang berisi informasi perangkat seperti parameter dasar atau tingkat interupsi dari registri. Untuk deskripsi lengkap tentang arti anggota ini untuk driver miniport SCSI, lihat HwScsiFindAdapter.

[in, out] ConfigInfo

Arahkan ke struktur PORT_CONFIGURATION_INFORMATION yang berisi informasi konfigurasi untuk HBA.

[out] Again

Anggota cadangan ketika digunakan oleh salah satu driver miniport pengemudi Storport. Dengan driver miniport SCSI, anggota ini menunjuk ke variabel BOOLEAN yang memberi tahu driver port apakah harus memanggil rutinitas ini lagi. Untuk informasi selengkapnya tentang arti anggota ini untuk driver miniport SCSI, lihat HwScsiFindAdapter.

Nilai kembali

Rutinitas yang dideklarasikan oleh prototipe ini harus mengembalikan salah satu nilai status berikut:

Menampilkan kode Deskripsi
SP_RETURN_FOUND Menunjukkan HBA yang didukung ditemukan dan bahwa informasi konfigurasi yang relevan dengan HBA berhasil ditentukan dan diatur dalam struktur PORT_CONFIGURATION_INFORMATION.
SP_RETURN_ERROR Menunjukkan HBA ditemukan tetapi ada kesalahan saat mendapatkan informasi konfigurasi. Jika memungkinkan, kesalahan seperti itu harus dicatat dengan ScsiPortLogError.
SP_RETURN_BAD_CONFIG Menunjukkan informasi konfigurasi yang disediakan tidak valid untuk adaptor.
SP_RETURN_NOT_FOUND Menunjukkan tidak ada HBA yang didukung yang ditemukan untuk informasi konfigurasi yang disediakan.

Keterangan

Deklarasi ini digunakan oleh driver miniport SCSI dan StorPort.

Untuk informasi selengkapnya tentang versi rutinitas driver miniport SCSI yang terkait dengan deklarasi ini, lihat HwScsiFindAdapter.

Untuk informasi selengkapnya tentang versi rutinitas driver Storport yang terkait dengan deklarasi ini, lihat HwStorFindAdapter.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header srb.h (termasuk Storport.h, Srb.h, Storport.h)

Lihat juga

HwScsiFindAdapter

HwStorFindAdapter