共用方式為

StorPortPoFxActivateComponent 函式 （storport.h）

  • 發行項

StorPortPoFxActivateComponent 例程會遞增存儲設備指定元件上的啟用參考計數。

語法

ULONG StorPortPoFxActivateComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

參數

[in] HwDeviceExtension

主機總線適配卡 （HBA） 的硬體裝置擴充功能指標。

[in, optional] Address

儲存裝置單位的位址。 啟用記憶體配接器元件時，此參數 NULL。

[in, optional] Srb

觸發元件啟用的SRB。 如果迷你埠為未透過 Storport 傳送的要求啟用裝置元件，則此參數會 NULL。

[in] Component

識別元件的索引。 這個參數是 STOR_POFX_DEVICE 結構中 Components 陣列的索引，迷你埠驅動程式已向裝置註冊，並 呼叫 storPortInitializePoFxPower。 如果 元件 數位件包含 N 個元素，元件索引的範圍從 0 到 N–1。

[in] Flags

未使用。 設定為 0。

傳回值

StorPortPoFxActivateComponent 例程會傳回下列其中一個狀態代碼：

傳回碼 描述
STOR_STATUS_SUCCESS
 記憶體裝置啟用參考已成功遞增，且元件處於作用中狀態。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 或 Device 為 NULL。

-或-

位址 指向無效的單位地址結構。

-或-

找不到 位址 所指定的儲存裝置。

-或-

存儲設備未向電源管理架構 （PoFx） 註冊。

-或-

Srb 所指向的 SRB 不會從 Storport 傳送。

-或-

Flags 參數為非零。
STOR_STATUS_INVALID_DEVICE_REQUEST
 配接器或單位不支援PoFx。
STOR_STATUS_INVALID_IRQL
 目前的 IRQL > DISPATCH_LEVEL。
STOR_STATUS_BUSY
 記憶體裝置啟用參考已成功遞增，但元件仍處於閑置狀態

言論

目前，適配卡裝置和單位裝置的元件計數上限為1。 Component 中的索引必須一律設定為 0。

StorPortPoFxActivateComponent 的每個呼叫都必須與 storPortPoFxIdleComponent 的後續呼叫相符。

要求

要求 價值
最低支援的用戶端 從 Windows 8 開始提供。
目標平臺 普遍
標頭 storport.h
連結庫 Storport.lib
IRQL IRQL <= DISPATCH_LEVEL

另請參閱

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent