StorPortPoFxSetPerfState 函式 (storport.h)

StorPortPoFxSetPerfState 會設定元件的 P 狀態 (效能或「perf」 狀態) 。

語法

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

參數

HwDeviceExtension

迷你埠裝置延伸模組的指標。

Address

正在註冊之裝置的位址。 目前僅支援介面卡,因此 Address 必須是 Null。

Component

索引,識別要管理其 P 狀態的元件。 此參數是STOR_POFX_DEVICE結構中Components陣列的索引,迷你埠用來註冊 Storport PoFx 支援的裝置。 如果 Components 陣列包含 N 個元素,元件索引的範圍從 0 到 N–1。

Flags

目前必須設定為 Null。

SetIndex

先前註冊之效能集的索引。

State

如果 perf 集合包含離散 P 狀態,這應該是索引值。 如果 perf 集合是範圍,則這應該是該範圍內的值。

Context

將傳遞給 perf set 變更回呼的任意內容。

傳回值

StorPortPoFxSetPerfState 會在成功完成時傳回STOR_STATUS_SUCCESS,如果已停用執行時間電源,或錯誤碼,例如下列其中一項:

錯誤碼 意義
STOR_STATUS_INVALID_PARAMETER 其中一個參數無效;例如, 位址旗標 不是 Null。
STOR_STATUS_UNSUCCESSFUL 介面卡未註冊以進行閒置偵測。

必要條件

   
最低支援的用戶端 Windows 8
標頭 storport.h