Funzione PerfQueryCounterData (perflib.h)

Articolo
08/25/2023

Ottiene i valori dei contatori delle prestazioni che corrispondono alle specifiche del contatore nella query specificata.

Sintassi

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

Parametri

[in] hQuery

Handle di una query per le specifiche del contatore dei contatori delle prestazioni per cui si desidera ottenere i valori.

[out, optional] pCounterBlock

Puntatore a un buffer con spazio sufficiente per ricevere la quantità di dati specificati dal parametro cbCounterBlock , in byte. Può essere NULL se

cbCounterBlock è 0.

cbCounterBlock

Dimensione del buffer specificata dal parametro pCounterBlock , espressa in byte.

[out] pcbCounterBlockActual

Le dimensioni del buffer effettivamente necessarie per ottenere i valori del contatore delle prestazioni. Il significato dipende dal valore che la funzione

Restituisce.

Valore restituito della funzione	Significato di pcbCounterBlockActual
ERROR_SUCCESS	Numero di byte di valori del contatore delle prestazioni archiviati nella funzione nel buffer specificato da pCounterBlock .
ERROR_NOT_ENOUGH_MEMORY	The dimensioni del buffer necessario per archiviare i valori del contatore delle prestazioni, in byte. Ingrandire il buffer in base alle esigenze dimensione e chiamare di nuovo la funzione.
Altro	Il valore non è definito e non deve essere usato.

Valore restituito della funzione

Significato di pcbCounterBlockActual

ERROR_SUCCESS

Numero di

byte di valori del contatore delle prestazioni archiviati nella funzione nel buffer specificato da pCounterBlock .

ERROR_NOT_ENOUGH_MEMORY

The

dimensioni del buffer necessario per archiviare i valori del contatore delle prestazioni, in byte. Ingrandire il buffer in base alle esigenze

dimensione e chiamare di nuovo la funzione.

Altro

Il valore non è definito e non deve essere usato.

Valore restituito

Codice restituito	Descrizione
ERROR_SUCCESS	La funzione ha archiviato correttamente tutti i valori del contatore delle prestazioni richiesti nel buffer specificato da pCounterBlock . Il valore che pcbCounterBlockActual punta a indica la quantità di informazioni effettivamente archiviate nel buffer, in byte.
ERROR_NOT_ENOUGH_MEMORY	Il buffer specificato da pCounterBlock non è sufficiente per archiviare tutti i valori del contatore delle prestazioni richiesti. Il valore che pcbCounterBlockActual punta a indica le dimensioni del buffer necessarie per archiviare tutte le informazioni. Ingrandire il buffer in base alle esigenze dimensione e chiamare di nuovo la funzione.

Per altri tipi di errori, il valore restituito è un codice di errore di sistema.

Commenti

Le informazioni sui valori del contatore delle prestazioni vengono scritte nel buffer specificato da pCounterBlock come blocco PERF_DATA_HEADER , costituito PERF_DATA_HEADER struttura seguita da una sequenza di blocchi PERF_COUNTER_HEADER .

Requisiti


Client minimo supportato	Windows 10 versione 1607 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	perflib.h
Libreria	AdvAPI32.lib
DLL	AdvAPI32.dll

Vedi anche

PERF_COUNTER_HEADER

PERF_DATA_HEADER

Condividi tramite