Fungsi ScsiPortWmiPostProcess (scsiwmi.h)

Artikel
02/29/2024

ScsiPortWmiPostProcess rutin memperbarui konteks permintaan untuk WMI SRB.

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