Funzione ZwPowerInformation (ntddk.h)

Articolo
02/29/2024

La routine ZwPowerInformation imposta o recupera le informazioni sull'alimentazione del sistema.

Sintassi

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

Parametri

[in] InformationLevel

Specifica il livello di informazioni richiesto, che indica le specifiche informazioni sull'alimentazione da impostare o recuperare. Attualmente, l'unico valore supportato POWER_INFORMATION_LEVEL è PlatformInformation.

Valore	Significato
PlatformInformation	Le informazioni rappresentano le funzionalità di alimentazione attualmente supportate del sistema. Le informazioni possono cambiare man mano che vengono installati i driver. Ad esempio, l'installazione di driver di dispositivo legacy che non supportano il risparmio energia potrebbe modificare le funzionalità del sistema.

[in, optional] InputBuffer

Puntatore a un buffer di input allocato dal chiamante. Questo parametro deve essere NULL; in caso contrario , viene restituito ERROR_INVALID_PARAMETER.

[in] InputBufferLength

Dimensioni, in byte, del buffer in InputBuffer. Il parametro deve essere impostato su zero.

[out, optional] OutputBuffer

Puntatore a un buffer di output. Il tipo di dati di questo buffer dipende dal livello di informazioni richiesto nel parametro InformationLevel . Per il livello PlatformInformation , l'unico valore attualmente supportato, il parametro OutputBuffer è obbligatorio e deve essere del tipo POWER_PLATFORM_INFORMATION .

[in] OutputBufferLength

Dimensioni, in byte, del buffer di output. A seconda del livello di informazioni richiesto, il buffer può essere ridimensionato in modo variabile. PlatformInformation, l'unico valore attualmente supportato, richiede un buffer che corrisponde alle dimensioni di una struttura POWER_PLATFORM_INFORMATION .

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha esito positivo. Se la chiamata non riesce, i codici di errore possibili includono quanto segue:

Codice restituito	Descrizione
STATUS_BUFFER_TOO_SMALL	Il buffer di output è di dimensioni insufficienti per contenere i dati restituiti.
STATUS_INVALID_PARAMETER	Il livello di informazioni PlatformInformation , che è l'unico valore attualmente supportato, non richiede alcun buffer di input e deve contenere un buffer di output. Il chiamante ha fornito un buffer di input o nessun buffer di output.
STATUS_ACCESS_DENIED	Il chiamante aveva diritti di accesso insufficienti per eseguire l'azione richiesta.

Commenti

NtPowerInformation e ZwPowerInformation sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Esempio

In questo esempio viene illustrata una chiamata di funzione valida.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Universale
Intestazione	ntddk.h (include Wdm.h, Ntddk.h, Ntpoapi.h)
Libreria	Ntoskrnl.lib
DLL	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Vedi anche

POWER_PLATFORM_INFORMATION

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

Condividi tramite