poFxQueryCurrentComponentPerfState 函式 (wdm.h)
PoFxQueryCurrentComponentPerfState 例程會擷取元件效能狀態集中的作用中效能狀態。
語法
NTSTATUS PoFxQueryCurrentComponentPerfState(
[in] POHANDLE Handle,
[in] ULONG Flags,
[in] ULONG Component,
[in] ULONG SetIndex,
[in] PULONGLONG CurrentPerf
);
參數
[in] Handle
句柄，表示使用電源管理架構註冊裝置 (PoFx) 。 設備驅動器先前已從 PoFxRegisterDevice 例程收到此句柄。
[in] Flags
設定為 0。 目前，此例程未定義任何旗標。
[in] Component
索引，識別正在擷取其效能狀態的元件。 此參數是裝置驅動程式用來向PoFx註冊裝置之PO_FX_DEVICE結構中 Components 陣列的索引。 如果 Components 陣列包含 N 個元素，元件索引的範圍從 0 到 N–1。
[in] SetIndex
索引，識別正在查詢其效能的效能狀態集。 此參數是裝置驅動程式用來向PoFx註冊元件效能狀態之PO_FX_COMPONENT_PERF_INFO結構中 PerfStateSets 陣列的索引。 如果 PerfStateSets 陣列包含 N 個元素，效能狀態集索引的範圍從 0 到 N–1。
[in] CurrentPerf
變數的指標，其中會傳回指定之效能狀態集的目前效能狀態。 如需傳回之值的詳細資訊，請參閱。
傳回值
如果要求的作業成功，PoFxQueryCurrentComponentPerfState 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | Description |
|---|---|
|
呼叫端為元件或元件狀態集提供了無效的索引。 |
備註
驅動程式可以呼叫 PoFxQueryCurrentComponentPerfState 例程，以擷取元件所指定效能狀態集的目前效能狀態。 如果呼叫成功，則會以指定集合目前效能狀態的值指標覆寫 CurrentPerf 參數。 此值可能是下列其中一項，視驅動程序傳遞給 PoFxRegisterComponentPerfStates 例程的PO_FX_COMPONENT_PERF_SET結構內容而定：
- 對於代表持續分佈效能狀態的效能狀態集，這是PO_FX_COMPONENT_PERF_SET結構之Minimum和 Maximum成員之間的值。
- 對於代表離散效能狀態數目的效能狀態集，這個值是PO_FX_COMPONENT_PERF_SET結構的 States 成員的索引。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 10 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h |
| 程式庫 | Ntoskrnl.lib |
| Dll | Ntoskrnl.exe |
| IRQL | <= DISPATCH_LEVEL |