storport.h) (STOR_POFX_DEVICE 結構

發行項
02/27/2024

STOR_POFX_DEVICE結構描述存儲設備對電源管理架構的電源屬性， (PoFx) 。

語法

typedef struct _STOR_POFX_DEVICE {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE, *PSTOR_POFX_DEVICE;

成員

Version

這個結構的版本號碼。將此成員設定為 STOR_POFX_DEVICE_VERSION_V1。

Size

此結構的大小。將此值設定為 STOR_POFX_DEVICE_SIZE。

ComponentCount

Components 陣列中的項目數目。將此成員設定為 1。目前，記憶體配接器或邏輯單元只支援單一元件。

Flags

裝置電源狀態功能旗標。迷你埠會設定一或多個 PoFx 裝置旗標，以啟用或停用電源狀態功能。

旗標是下列專案的位 OR 組合。

值	意義
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	指定在設定時，Storport 會在將配接器放入 D3 時停用中斷，並在繼續至 D0 時重新啟用中斷。
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	可讓 Storport 在支援時設定配接器的 D3 冷狀態。此旗標僅適用於配接器。
STOR_POFX_DEVICE_FLAG_NO_D0	要求電源 IRP 不會傳送至適配卡或單位的裝置物件。
STOR_POFX_DEVICE_FLAG_NO_D3	要求關閉電源 IRP 不會傳送至適配卡或單位的裝置物件。
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	如果裝置進入閑置狀態或閑置狀態時關閉電源，迷你埠將無法讓儲存裝置處於傾印模式。此旗標指出裝置在閑置時是否可供傾印。

Components[ANYSIZE_ARRAY]

這個成員是一或多個 STOR_POFX_COMPONENT 元素陣列中的第一個專案。如果陣列包含多個元素，則其他元素會緊接在 STOR_POFX_DEVICE 結構後面。數位包含裝置中每個元件的一個專案。目前，存儲設備只有一個元件，因此不需要額外的元件結構。

備註

若要註冊 Storport PoFx 支援的儲存配接器，迷你埠驅動程式會在其 HwStorInitialize 例程中呼叫 StorPortEnablePassiveInitialization，並實作 HwStorPassiveInitializeRoutine。迷你埠會在其 HwStorPassiveInitializeRoutine 內呼叫 StorPortInitializePoFxPower，以提供配接器元件的相關信息。

若要註冊 Storport PoFx 支援的儲存單元，迷你埠驅動程式會實作 HwStorUnitControl 回呼例程，並提供 ScsiUnitPoFxPowerInfo 單元控制程式代碼的處理。處理 ScsiUnitPoFxPowerInfo 控件程式代碼時，如果已啟用單元元件的閒置電源管理，迷你埠會呼叫 StorPortInitializePoFxPower。

其 Components 陣列索引所識別之儲存設備的元件。記憶體裝置只有一個元件，因此會使用 0 的索引。 StorPortPoFxActivateComponent 和 StorPortPoFxIdleComponent 等例程會使用元件的數位索引來識別元件。