NtPowerInformation 函式 (wdm.h)
NtPowerInformation 例程會設定或擷取系統電源資訊。
語法
__kernel_entry NTSYSCALLAPI NTSTATUS NtPowerInformation(
[in] POWER_INFORMATION_LEVEL InformationLevel,
[in, optional] PVOID InputBuffer,
[in] ULONG InputBufferLength,
[out, optional] PVOID OutputBuffer,
[in] ULONG OutputBufferLength
);
參數
[in] InformationLevel
指定要求的信息層級，指出要設定或擷取的特定電源資訊。 目前唯 一支援的POWER_INFORMATION_LEVEL 值為 PlatformInformation。
| 值 | Description |
|---|---|
| PlatformInformation | 資訊代表系統目前支援的電源功能。 安裝驅動程式時的資訊可能會變更。 例如，安裝不支援電源管理的舊版設備驅動器可能會修改系統的功能。 |
[in, optional] InputBuffer
呼叫端配置的輸入緩衝區指標。 此參數必須是 NULL，否則 會傳回ERROR_INVALID_PARAMETER 。
[in] InputBufferLength
InputBuffer 緩衝區的大小，以位元組為單位。 參數必須設定為零。
[out, optional] OutputBuffer
輸出緩衝區的指標。 此緩衝區的數據類型取決於 InformationLevel 參數中所要求的資訊層級。 針對 PlatformInformation 層級，唯一支援的值是 OutputBuffer 參數，而且必須是 POWER_PLATFORM_INFORMATION 類型。
[in] OutputBufferLength
輸出緩衝區的大小，以位元組為單位。 視要求的信息層級而定，緩衝區的大小可能會有所不同。 PlatformInformation 是目前唯一支援的值，需要具有 POWER_PLATFORM_INFORMATION 結構大小的緩衝區。
傳回值
如果呼叫成功，則傳回STATUS_SUCCESS。 如果呼叫失敗，可能的錯誤碼包括下列各項：
| 傳回碼 | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | 輸出緩衝區的大小不足，無法包含所傳回的數據。 |
| STATUS_INVALID_PARAMETER | PlatformInformation 資訊層級是目前唯一支援的值，不需要任何輸入緩衝區，而且必須包含輸出緩衝區。 呼叫端提供輸入緩衝區或沒有輸出緩衝區。 |
| STATUS_ACCESS_DENIED | 呼叫端的訪問許可權不足，無法執行要求的動作。 |
備註
NtPowerInformation 和 ZwPowerInformation 是相同 Windows 原生系統服務例程的兩個版本。
對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。
範例
此範例說明有效的函數調用。
POWER_PLATFORM_INFORMATION PlatformInfo = {0};
NTSTATUS Result = NtPowerInformation(PlatformInformation, NULL, 0, &PlatformInfo, sizeof(PlatformInfo));
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntpoapi.h) |
| 程式庫 | Ntoskrnl.lib |
| Dll | Ntoskrnl.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS、 PowerIrpDDis |