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