共用方式為

StorPortPoFxSetComponentResidency 函式 （storport.h）

  • 發行項

StorPortPoFxSetComponentResidency 例程會設定在元件進入閑置條件之後，儲存裝置元件可能保持閑置的估計時間。

語法

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

參數

[in] HwDeviceExtension

主機總線適配卡 （HBA） 的硬體裝置擴充功能指標。 這是在先前呼叫 StorPortInitializePoFxPower 之前註冊裝置的裝置擴充功能。

[in, optional] Address

儲存裝置單位的位址。 設定記憶體配接器元件的落地時，此參數 NULL。

[in] Component

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

[in] Residency

估計落地時間，以 100 奈秒為單位。 此參數是電源管理架構 （PoFx） 的提示，說明元件在從作用中條件轉換為閑置條件之後，可能會保持閑置的時間長度。

傳回值

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

傳回碼 描述
STOR_STATUS_SUCCESS
 已成功設定元件落地。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension 或 Device 為 NULL。

-或-

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

-或-

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

-或-

Component 中的索引會指定大於裝置元件計數的元件。
STOR_STATUS_INVALID_DEVICE_REQUEST
 記憶體裝置未向PoFx註冊。
STOR_STATUS_INVALID_IRQL
 目前的 IRQL > DISPATCH_LEVEL。

要求

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

另請參閱

PoFxSetComponentResidency