storPortPoFxIdleComponent 函式 (storport.h)

StorPortPoFxIdleComponent 例程會遞減儲存裝置指定元件的啟用參考計數。

語法

ULONG StorPortPoFxIdleComponent(
  [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。 如果迷你埠在內部閒置裝置元件，則此參數為 NULL 。

[in] Component

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

[in] Flags

未使用。 設定為 0。

傳回值

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

傳回碼	Description
STOR_STATUS_SUCCESS	記憶體裝置啟用參考已成功遞減，且元件處於閑置狀態。
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension 或 Device 為 NULL。 -或- 位址 會指向無效的單位地址結構。 -或- 找不到 位址 所指定的儲存裝置。 -或- 儲存裝置未向電源管理架構註冊， (PoFx) 。 -或- Srb 指向的 SRB 不會從 Storport 傳送。 -或- Flags 參數為非零。
STOR_STATUS_INVALID_DEVICE_REQUEST	配接器或單位不支援PoFx。 -或- StorPortPoFxIdleComponent 是使用非作用中的元件呼叫，且未執行先前呼叫 StorPortPoFxActivateComponent 的 Srb。
STOR_STATUS_INVALID_IRQL	目前的 IRQL > DISPATCH_LEVEL。
STOR_STATUS_BUSY	裝置元件的使用中參考已遞減，但元件仍在使用中。

備註

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

每次呼叫 StorPortPoFxIdleComponent 都必須與先前呼叫 StorPortPoFxActivateComponent 相符。

規格需求

需求	值
最低支援的用戶端	從 Windows 8 開始提供。
目標平台	Universal
標頭	storport.h
IRQL	任何

另請參閱

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxActivateComponent