Fungsi ScsiPortWmiFireLogicalUnitEvent (scsiwmi.h)

Rutinitas ScsiPortWmiFireLogicalUnitEvent mengirimkan peristiwa yang terkait dengan unit logis ke driver port untuk pengiriman ke konsumen data WMI yang telah meminta pemberitahuan peristiwa tersebut.

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

void ScsiPortWmiFireLogicalUnitEvent(
  [in] PVOID  HwDeviceExtension,
  [in] UCHAR  PathId,
  [in] UCHAR  TargetId,
  [in] UCHAR  Lun,
  [in] LPGUID Guid,
  [in] ULONG  InstanceIndex,
  [in] ULONG  EventDataSize,
  [in] PVOID  EventData
);

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. Pengandar porta membebaskan memori ini ketika melepas perangkat.

[in] PathId

Mengidentifikasi bus SCSI; SP_UNTAGGED menunjukkan semua bus yang dikendalikan oleh HBA.

[in] TargetId

Mengidentifikasi pengontrol target atau perangkat pada bus yang diberikan; SP_UNTAGGED menunjukkan semua target di bus.

[in] Lun

Mengidentifikasi unit logis untuk pengontrol target atau perangkat yang diberikan; SP_UNTAGGED menunjukkan semua unit logis untuk pengontrol target yang diberikan pada bus yang diberikan.

[in] Guid

Penunjuk ke GUID yang mewakili blok peristiwa.

[in] InstanceIndex

Jika blok peristiwa memiliki beberapa instans, tentukan indeks instans.

[in] EventDataSize

Menentukan jumlah byte data di EventData, tidak termasuk byte pad di awal buffer data peristiwa. Jika tidak ada data yang dihasilkan untuk suatu peristiwa, EventDataSize harus diatur ke nol.

[in] EventData

Pointer ke buffer miniport yang dialokasikan driver yang berisi data yang dihasilkan oleh driver miniport untuk acara tersebut. Buffer harus setidaknya ukuran data peristiwa ditambah 0x40 byte pad di awal buffer.

Nilai kembali

Tidak ada

Keterangan

Driver miniport memanggil ScsiPortWmiFireLogicalUnitEvent untuk mengirim peristiwa yang terkait dengan adaptor atau unit logis ke semua konsumen data yang telah meminta pemberitahuan peristiwa tersebut.

Driver miniport mengirimkan peristiwa hanya jika sebelumnya telah diaktifkan oleh rutinitas HwScsiWmiFunctionControl driver miniport.

Driver harus menulis data peristiwa ke buffer yang ditunjukkan oleh EventData pada offset 0x40. Byte 0x40 pertama digunakan oleh SCSI WMI. Jika tidak ada data yang diteruskan kembali dengan peristiwa, eventData harus 0x40 byte panjangnya.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	scsiwmi.h (termasuk Miniport.h, Scsi.h)

Lihat juga

HwScsiWmiFunctionControl