struktur SCSI_WMILIB_CONTEXT (scsiwmi.h)

Artikel
02/26/2024

Struktur SCSI_WMILIB_CONTEXT menyediakan informasi pendaftaran untuk data driver miniport dan blok peristiwa dan menentukan titik masuk untuk rutinitas panggilan balik HwScsiWmiXxx driver miniport.

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

typedef struct _SCSIWMILIB_CONTEXT {
  ULONG                     GuidCount;
  PSCSIWMIGUIDREGINFO       GuidList;
  PSCSIWMI_QUERY_REGINFO    QueryWmiRegInfo;
  PSCSIWMI_QUERY_DATABLOCK  QueryWmiDataBlock;
  PSCSIWMI_SET_DATABLOCK    SetWmiDataBlock;
  PSCSIWMI_SET_DATAITEM     SetWmiDataItem;
  PSCSIWMI_EXECUTE_METHOD   ExecuteWmiMethod;
  PSCSIWMI_FUNCTION_CONTROL WmiFunctionControl;
} SCSI_WMILIB_CONTEXT, *PSCSI_WMILIB_CONTEXT;

Anggota

GuidCount

Menentukan jumlah struktur dalam array SCSIWMIGUIDREGINFO di GuidList.

GuidList

Menunjuk ke array struktur GuidCount SCSIWMIGUIDREGINFO yang berisi informasi pendaftaran untuk setiap blok.

QueryWmiRegInfo

Menunjuk ke rutinitas HwScsiWmiQueryReginfo driver, yang merupakan titik masuk yang diperlukan untuk driver miniport yang mendukung WMI.

QueryWmiDataBlock

Menunjuk ke rutinitas HwScsiWmiQueryDataBlock driver, yang merupakan titik masuk yang diperlukan untuk driver miniport yang mendukung WMI.

SetWmiDataBlock

Menunjuk ke rutinitas HwScsiWmiSetDataBlock driver, yang merupakan titik masuk opsional untuk driver miniport yang mendukung WMI. Jika driver miniport tidak menerapkan rutinitas ini, maka harus mengatur anggota ini ke NULL

SetWmiDataItem

Menunjuk ke rutinitas HwScsiWmiSetDataItem driver, yang merupakan titik masuk opsional untuk driver miniport yang mendukung WMI. Jika driver miniport tidak menerapkan rutinitas ini, maka harus mengatur anggota ini ke NULL.

ExecuteWmiMethod

Menunjuk ke rutinitas HwScsiWmiExecuteMethod driver, yang merupakan titik masuk opsional untuk driver miniport yang mendukung WMI. Jika driver miniport tidak menerapkan rutinitas ini, maka harus mengatur anggota ini ke NULL

WmiFunctionControl

Menunjuk ke rutinitas HwScsiWmiFunctionControl driver, yang merupakan titik masuk opsional untuk driver miniport yang mendukung WMI. Jika driver miniport tidak menerapkan rutinitas ini, maka harus mengatur anggota ini ke NULL.

Keterangan

Driver miniport SCSI yang mendukung WMI menyimpan struktur SCSI_WMILIB_CONTEXT yang diinisialisasi (atau penunjuk ke struktur seperti itu) dalam ekstensi perangkatnya. Driver miniport dapat menggunakan struktur SCSI_WMILIB_CONTEXT yang sama untuk beberapa objek perangkat jika setiap objek perangkat memasok kumpulan blok data yang sama.

Ketika driver miniport menerima SRB di mana anggota Fungsi diatur ke SRB_FUNCTION_WMI, ia memanggil ScsiPortWmiDispatchFunction dengan parameter permintaan, termasuk penunjuk ke struktur SCSI_WMILIB_CONTEXT yang diinisialisasi. ScsiPortWmiDispatchFunction menangani permintaan dengan memanggil rutinitas HwScsiWmiXxxx driver miniport yang sesuai.

Jika driver miniport tidak menerapkan rutinitas HwScsiWmiXxx opsional, driver port mengembalikan status yang sesuai ke pemanggil.