SCSI_WMILIB_CONTEXT結構（scsiwmi.h）

發行項
2025/02/07

SCSI_WMILIB_CONTEXT結構提供迷你埠驅動程序數據和事件區塊的註冊資訊，並定義迷你埠驅動程式 HwScsiWmiXxx 回呼例程的進入點。

注意 SCSI 連接埠驅動程式和 SCSI 迷你埠驅動程式模型未來可能會改變或無法使用。相反地，我們建議使用 Storport 驅動程式和 Storport miniport 驅動程式模型。

語法

C++

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;

成員

GuidCount

指定位於 guidList SCSIWMIGUIDREGINFO 陣列中的結構數目。

GuidList

指向 GuidCount SCSIWMIGUIDREGINFO 結構的陣列，其中包含每個區塊的註冊資訊。

QueryWmiRegInfo

指向驅動程式 HwScsiWmiQueryReginfo 例程，這是支援 WMI 的迷你埠驅動程式所需的進入點。

QueryWmiDataBlock

指向驅動程式 HwScsiWmiQueryDataBlock 例程，這是支援 WMI 的迷你埠驅動程式所需的進入點。

SetWmiDataBlock

指向驅動程式 HwScsiWmiSetDataBlock 例程，這是支援 WMI 之迷你埠驅動程式的選擇性進入點。如果迷你埠驅動程式未實作此例程，則必須將此成員設定為 NULL

SetWmiDataItem

指向驅動程式 HwScsiWmiSetDataItem 例程，這是支援 WMI 的迷你埠驅動程式的選擇性進入點。如果迷你連接埠驅動程式未實作此例程，則必須將此成員設定為 NULL。

ExecuteWmiMethod

指向驅動程式 HwScsiWmiExecuteMethod 例程，這是支援 WMI 的迷你埠驅動程式的選擇性進入點。如果迷你埠驅動程式未實作此例程，則必須將此成員設定為 NULL

WmiFunctionControl

指向驅動程式 HwScsiWmiFunctionControl 例程，這是支援 WMI 的迷你埠驅動程式的選擇性進入點。如果迷你連接埠驅動程式未實作此例程，則必須將此成員設定為 NULL。

言論

支援 WMI 的 SCSI 迷你埠驅動程式會在其裝置延伸模組中儲存已初始化的SCSI_WMILIB_CONTEXT結構（或這類結構的指標）。如果每個裝置物件提供相同的數據區塊集，迷你埠驅動程式就可以針對多個裝置物件使用相同的SCSI_WMILIB_CONTEXT結構。

當迷你埠驅動程式收到 SRB 時，函式成員設定為 SRB_FUNCTION_WMI，它會使用要求參數呼叫 ScsiPortWmiDispatchFunction，包括初始化SCSI_WMILIB_CONTEXT結構的指標。 ScsiPortWmiDispatchFunction 呼叫迷你埠驅動程序的適當 HwScsiWmiXxx 例程來處理要求。

如果迷你埠驅動程式未實作選擇性 HwScsiWmiXxx 例程，埠驅動程式會將適當的狀態傳回給呼叫端。