ZwPowerInformation 函式 (ntddk.h)

  • 發行項

ZwPowerInformation 例程會設定或擷取系統電源資訊。

語法

NTSYSAPI NTSTATUS ZwPowerInformation(
  [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。

值 意義
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 Native System Services 例程的兩個版本。

針對來自內核模式驅動程式的呼叫，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
標頭 ntddk.h (包含 Wdm.h、Ntddk.h、Ntpoapi.h)
程式庫 Ntoskrnl.lib
Dll Ntoskrnl.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)

另請參閱

POWER_PLATFORM_INFORMATION

使用 Nt 和 Zw 版本的原生系統服務例程