Funzione PerfQueryCounterInfo (perflib.h)

Articolo
03/08/2023

Ottiene le specifiche del contatore nella query specificata.

Sintassi

ULONG PerfQueryCounterInfo(
  [in]            HANDLE                   hQuery,
  [out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
                  DWORD                    cbCounters,
  [out]           LPDWORD                  pcbCountersActual
);

Parametri

[in] hQuery

Handle per la query per cui si desidera ottenere le specifiche del contatore

[out, optional] pCounters

Puntatore a un buffer sufficientemente grande da contenere la quantità di dati specificati dal parametro cbCounters , in byte. Può essere NULL se cbCounters è 0.

cbCounters

Dimensioni del buffer pCounters , in byte.

[out] pcbCountersActual

Le dimensioni del buffer effettivamente necessarie per ottenere le specifiche del contatore. Il significato dipende dal valore che la funzione

Restituisce.

Valore restituito della funzione	Significato di pcbCountersActual
ERROR_SUCCESS	Numero di byte di informazioni sulle specifiche del contatore specificate dalla funzione nel buffer specificato da pCounters .
ERROR_NOT_ENOUGH_MEMORY	The dimensioni del buffer necessario per archiviare le informazioni sulle specifiche del contatore, 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 pcbCountersActual

ERROR_SUCCESS

Numero di

byte di informazioni sulle specifiche del contatore specificate dalla funzione nel buffer specificato da pCounters .

ERROR_NOT_ENOUGH_MEMORY

The

dimensioni del buffer necessario per archiviare le informazioni sulle specifiche del contatore, 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 tutte le informazioni sulle specifiche del contatore nel buffer specificato da pCounters . Il valore che pcbCountersActual punta a indica la quantità di informazioni effettivamente archiviate nel buffer, in byte.
ERROR_NOT_ENOUGH_MEMORY	Il buffer specificato da pCounters non è sufficiente per archiviare tutte le informazioni sulle specifiche del contatore. Valore che pcbCountersActual 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 sulle specifiche del contatore vengono scritte nel buffer specificato da pCounters come sequenza di blocchi PERF_COUNTER_IDENTIFIER . Dimensioni in byte di

la sequenza di blocchi viene scritta in pcbCountersActual. Ogni blocco di PERF_COUNTER_IDENTIFIER è costituito

di una struttura PERF_COUNTER_IDENTIFIER , seguita facoltativamente da un UTF-16LE con terminazione Null

nome dell'istanza, seguito dalla spaziatura interna in modo che le dimensioni dell'oggetto

PERF_COUNTER_IDENTIFIER blocco è un multiplo di 8 byte. Le dimensioni di ogni blocco, inclusa la struttura PERF_COUNTER_IDENTIFIER , il nome dell'istanza e la spaziatura interna, sono determinate dal membro Size della struttura PERF_COUNTER_IDENTIFIER , che sarà un multiplo di 8 byte.

Requisiti

Requisito	Valore
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_IDENTIFIER

Condividi tramite