SCSI_WMILIB_CONTEXT結構 (scsiwmi.h)

發行項
02/29/2024

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

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

語法

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 例程，埠驅動程式會將適當的狀態傳回給呼叫端。