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.
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) |