SCSIWMIGUIDREGINFO 結構 (scsiwmi.h)

發行項
02/26/2024

SCSIWMIGUIDREGINFO 結構包含 SCSI 迷你埠驅動程式所支援之指定資料或事件區塊的相關信息。

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

語法

typedef struct {
  LPCGUID Guid;
  ULONG   InstanceCount;
  ULONG   Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;

成員

Guid

指向識別區塊的 GUID。

InstanceCount

指定為區塊定義的實例數目。

Flags

表示區塊的特性。 SCSI 埠驅動程式會代表迷你埠驅動程式設定下列所有WMIREG_FLAG_XXX 。迷你埠驅動程式可能會設定下列一或多個旗標：

WMIREG_FLAG_EVENT_ONLY_GUID

區塊只能啟用或停用為事件，而且無法查詢或設定。如果清除此旗標，也可以查詢或設定區塊。

WMIREG_FLAG_EXPENSIVE

要求埠驅動程式第一次在數據取用者開啟數據區塊時傳送啟用集合 SRB，並在最後一個數據取用者關閉數據區塊時，停用收集 SRB。如果收集這類數據會影響效能，建議您這麼做。在數據取用者透過開啟區塊明確要求數據之前，迷你埠驅動程式不需要收集數據。

WMIREG_FLAG_REMOVE_GUID

拿掉設定時先前註冊區塊的支援。

備註

迷你埠驅動程式會將指標傳遞至SCSI_WMILIB_CONTEXT，其中包含 ScsiPortWmiDispatchFunction之 WmiLibInfo 參數中的 SCSIWMIREGGUID 陣列。迷你埠驅動程式會在每次呼叫 ScsiPortWmiDispatchFunction 時傳遞此資訊。數位中的每個 SCSIWMIREGGUID 結構都代表其中一個迷你埠驅動程式的數據或事件區塊。

迷你埠驅動程式的 SCSIWMIREGGUID 陣列應該包含針對其裝置類型在 wmicore.mof 中定義的任何標準數據區塊，而且可能包含迷你埠驅動程式定義的數據和事件區塊。迷你埠驅動程式會在MOF檔案中定義自訂數據和事件區塊，它會編譯為附加至迷你埠驅動程式二進位映像的資源，並在迷你埠驅動程式的HwScsiWmiQueryReginfo 例程的 MofResourceName 參數中指定。

如需定義區塊的詳細資訊，請參閱 Windows Management Instrumentation。