PSCSIWMI_QUERY_REGINFO fungsi panggilan balik (scsiwmi.h)

Artikel
03/01/2024

Rutinitas HwScsiWmiQueryReginfo driver miniport dipanggil untuk mendapatkan informasi tentang data dan blok peristiwa yang akan didaftarkan atas nama driver miniport oleh driver port SCSI. Rutinitas ini diperlukan.

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

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

UCHAR PscsiwmiQueryReginfo(
  [in]  PVOID DeviceContext,
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [out] PWSTR *MofResourceName
)
{...}

Parameter

[in] DeviceContext

Menunjuk ke nilai konteks miniport yang ditentukan driver yang diteruskan ke ScsiPortWmiDispatchFunction.

[in] RequestContext

Menunjuk ke struktur SCSIWMI_REQUEST_CONTEXT yang diteruskan driver miniport ke ScsiPortWmiDispatchFunction.

[out] MofResourceName

Menunjuk ke string Unicode yang dihentikan null yang menunjukkan nama sumber daya MOF yang dilampirkan ke file gambar biner driver miniport. String ini dapat dinyatakan sebagai konstanta dalam driver miniport. Jika driver miniport tidak memiliki sumber daya MOF yang terpasang, driver harus mengatur MofResourceName ke NULL.

Nilai kembali

HwScsiWmiQueryReginfo selalu mengembalikan SRB_STATUS_SUCCESS.

Keterangan

Ketika driver miniport menerima SRB di mana anggota Fungsi diatur ke SRB_FUNCTION_WMI, ia memanggil ScsiPortWmiDispatchFunction dengan pointer ke struktur SCSI_WMILIB_CONTEXT yang diinisialisasi dan MinorFunction diatur ke Srb-WmiSubFunction>. Jika MinorFunction menunjukkan permintaan informasi pendaftaran, driver port SCSI memanggil rutinitas HwScsiWmiQueryReginfo driver miniport.

Driver miniport menyediakan informasi pendaftaran baru atau yang diperbarui tentang blok individual, atau menunjukkan blok yang akan dihapus, dalam struktur SCSI_WMILIB_CONTEXT yang diteruskannya ke ScsiPortWmiDispatchFunction. Rutinitas HwScsiWmiQueryReginfo driver miniport memasok pointer ke nama sumber daya MOF-nya.

Driver miniport tidak boleh tertunda atau memblokir SRB. Driver miniport tidak boleh memanggil ScsiPortWmiPostProcess atau ScsiPortNotification dari rutinitas HwScsiWmiQueryReginfo .

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	scsiwmi.h (termasuk Scsiwmi.h)

Lihat juga

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction

Bagikan melalui