Fungsi ScsiPortWmiPostProcess (scsiwmi.h)
ScsiPortWmiPostProcess rutin memperbarui konteks permintaan untuk WMI SRB.
Sintaks
void ScsiPortWmiPostProcess(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
[in] UCHAR SrbStatus,
[in] ULONG BufferUsed
);
Parameter
[in] RequestContext
Penunjuk ke konteks permintaan untuk SRB ini.
[in] SrbStatus
Menentukan status SRB yang valid. Jika buffer output yang diteruskan ke driver miniport terlalu kecil untuk berisi semua data dari permintaan, driver miniport mengatur SrbStatus ke SRB_STATUS_DATA_OVERRUN.
[in] BufferUsed
Jika SrbStatus menunjukkan keberhasilan, driver miniport mengatur BufferUsed ke jumlah byte data yang ditulis ke buffer. Jika SrbStatus SRB_STATUS_DATA_OVERRUN, driver miniport mengatur BufferUsed ke jumlah byte yang diperlukan untuk menyelesaikan SRB dengan sukses.
Nilai kembali
Tidak ada
Keterangan
Driver miniport harus memanggil ScsiPortWmiPostProcess setelah permintaan WMI SRB diproses dan siap untuk diselesaikan.
Untuk SRB sinkron, ScsiPortWmiPostProcess dipanggil dalam rutinitas panggilan balik.
Untuk SRB yang tertunda, ScsiPortWmiPostProcess dipanggil setelah SRB diproses, dan sebelum selesai.
Jika driver miniport mengatur SrbStatus ke SRB_STATUS_DATA_OVERRUN dan mengatur BufferUsed, SRB WMI identik berturut-turut dengan buffer yang dialokasikan sama dengan atau lebih besar dari byte BufferUsed harus berhasil. Ini harus dicapai jika driver menetapkan nilai yang tepat untuk BufferUsed yang diperlukan untuk menyelesaikan permintaan saat memanggil ScsiPortWmiPostProcess dengan SrbStatus sama dengan SRB_STATUS_DATA_OVERRUN. Untuk struktur output berukuran variabel, buffer data input SRB harus memiliki informasi yang cukup untuk menentukan nilai BufferUsed yang tepat. Jika buffer data input tidak berisi informasi yang cukup, driver tidak boleh gagal SRB yang sama dua kali dengan SRB_STATUS_DATA_OVERRUN. Sebaliknya, driver harus mengatur SRB_STATUS_DATA_OVERRUN dan meminta ukuran minimum yang diperlukan untuk buffer output terlebih dahulu, dan kemudian mengatur SRB_STATUS_SUCCESS dan menunjukkan kegagalan dalam konten buffer output.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | scsiwmi.h (termasuk Miniport.h, Scsi.h) |