Função ZwPowerInformation (ntddk.h)

Artigo
02/07/2025

O ZwPowerInformation conjuntos de rotina ou recupera informações de energia do sistema.

Sintaxe

NTSYSAPI NTSTATUS ZwPowerInformation(
  [in]            POWER_INFORMATION_LEVEL InformationLevel,
  [in, optional]  PVOID                   InputBuffer,
  [in]            ULONG                   InputBufferLength,
  [out, optional] PVOID                   OutputBuffer,
  [in]            ULONG                   OutputBufferLength
);

Parâmetros

[in] InformationLevel

Especifica o nível de informações solicitado, que indica as informações de energia específicas a serem definidas ou recuperadas. Atualmente, o único valor de POWER_INFORMATION_LEVEL com suporte é PlatformInformation.

Valor	Significado
PlatformInformation	As informações representam os recursos de energia atualmente compatíveis com o sistema. As informações podem ser alteradas à medida que os drivers são instalados. Por exemplo, a instalação de drivers de dispositivo herdados que não dão suporte ao gerenciamento de energia pode modificar os recursos do sistema.

[in, optional] InputBuffer

Ponteiro para um buffer de entrada alocado por chamador. Esse parâmetro deve ser NULL, caso contrário, ERROR_INVALID_PARAMETER será retornado.

[in] InputBufferLength

Tamanho, em bytes, do buffer em InputBuffer. O parâmetro deve ser definido como zero.

[out, optional] OutputBuffer

Um ponteiro para um buffer de saída. O tipo de dados desse buffer depende do nível de informações solicitado no parâmetro InformationLevel. Para o nível PlatformInformation, o único valor com suporte no momento, o parâmetro OutputBuffer é necessário e deve ser do tipo POWER_PLATFORM_INFORMATION.

[in] OutputBufferLength

Tamanho, em bytes, do buffer de saída. Dependendo do nível de informações solicitado, o buffer pode ser dimensionado variavelmente. PlatformInformation, o único valor com suporte no momento, requer um buffer do tamanho de uma estrutura de POWER_PLATFORM_INFORMATION.

Valor de retorno

Retorna STATUS_SUCCESS se a chamada for bem-sucedida. Se a chamada falhar, os códigos de erro possíveis incluem o seguinte:

Código de retorno	Descrição
STATUS_BUFFER_TOO_SMALL	O buffer de saída é de tamanho insuficiente para conter os dados que estão sendo retornados.
STATUS_INVALID_PARAMETER	O nível de informações PlatformInformation, que é o único valor com suporte no momento, não requer nenhum buffer de entrada e deve conter um buffer de saída. O chamador forneceu um buffer de entrada ou nenhum buffer de saída.
STATUS_ACCESS_DENIED	O chamador não tinha direitos de acesso suficientes para executar a ação solicitada.

Observações

NtPowerInformation e ZwPowerInformation são duas versões da mesma rotina dos Serviços de Sistema Nativo do Windows.

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Exemplos

Este exemplo ilustra uma chamada de função válida.

POWER_PLATFORM_INFORMATION PlatformInfo = {0};
NTSTATUS Result = NtPowerInformation(PlatformInformation, NULL, 0, &PlatformInfo, sizeof(PlatformInfo));

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Universal
cabeçalho	ntddk.h (incluem Wdm.h, Ntddk.h, Ntpoapi.h)
biblioteca	Ntoskrnl.lib
de DLL	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte também

POWER_PLATFORM_INFORMATION

usando versões Nt e Zw das rotinas de serviços do sistema nativo

Compartilhar via