Funzione KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

Articolo
08/08/2023

La routine KeConvertPerformanceCounterToAuxiliaryCounter converte il valore del contatore delle prestazioni specificato in un valore del contatore ausiliario.

Sintassi

NTSTATUS KeConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONG64  PerformanceCounterValue,
  [out]           PULONG64 AuxiliaryCounterValue,
  [out, optional] PULONG64 ConversionError
);

Parametri

[in] PerformanceCounterValue

Valore del contatore delle prestazioni da convertire.

[out] AuxiliaryCounterValue

Puntatore alla variabile che contiene il valore del contatore ausiliario convertito.

[out, optional] ConversionError

Puntatore a una variabile che contiene l'errore di conversione stimato in unità di nanosecondo.

Valore restituito

KeConvertPerformanceCounterToAuxiliaryCounter può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
STATUS_SUCCESS	Conversione riuscita.
STATUS_NOT_SUPPORTED	Il contatore ausiliario non è supportato.
STATUS_INVALID_PARAMETER	Il valore PerformanceCounterValue non è valido. Ad esempio, il valore è precedente all'ultimo avvio/ripristino di sistema o non è compreso nell'intervallo +/- 10s rispetto al valore corrente del contatore delle prestazioni.
STATUS_UNSUCCESSFUL	La routine non può convertire il valore specificato con accuratezza accettabile.

Commenti

Assicurarsi che il valore del contatore delle prestazioni specificato sia:

Entro +/- 10s rispetto al valore corrente di lettura del contatore delle prestazioni.
Non prima del valore del contatore delle prestazioni registrato all'ultimo avvio o ripristino del sistema dallo stato S3/S4.

Il valore ConversionError è la differenza, in nanosecondi, tra il valore calcolato previsto e il valore calcolato effettivo per il contatore ausiliario. Se il valore ConversionError è maggiore del valore previsto (determinato dall'utente), chiamare di nuovo la routine.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 10.
Piattaforma di destinazione	Universale
Intestazione	wdm.h
Libreria	Ntoskrnl.lib
DLL	Hal.dll
IRQL	Qualsiasi livello

Vedi anche

KeConvertAuxiliaryCounterToPerformanceCounter

Condividi tramite