Funzione CounterInitialize
Registra il provider e inizializza i set di contatori.
Sintassi
ULONG WINAPI CounterInitialize(void);
Parametri
Questa funzione non ha parametri.
Valore restituito
Restituisce ERROR_SUCCESS in caso di esito positivo; in caso contrario, un codice di errore Win32 standard.
Commenti
Il provider chiama questa funzione. La funzione include chiamate alla funzione PerfStartProvider e alla funzione PerfSetCounterSetInfo .
Lo strumento CTRPP genera questa funzione inline quando si specifica l'argomento -o . Il nome della funzione include una stringa di prefisso se si specifica l'argomento -prefix .
Se si specificano gli argomenti -MemoryRoutines o -NotificationCallback (o si specifica l'attributo di callback per l'elemento provider ), la firma CounterInitialize viene modificata nel modo seguente:
ULONG WINAPI CounterInitialize(
__in_opt PERFLIBREQUEST NotificationCallback,
__in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
__in_opt PERF_MEM_FREE MemoryFreeFunction,
__inout_opt PVOID MemoryFunctionContext
);
dove
-
NotificationCallback
-
Nome della funzione di callback ControlCallback implementata per ricevere la notifica delle richieste consumer, ad esempio richieste di aggiunta o rimozione di contatori dalla query. Impostare su NULL se non si implementa la funzione di callback ControlCallback .
-
MemoryAllocationFunction
-
Nome della funzione di callback AllocateMemory che PERFLIB chiama per allocare memoria. Impostare su NULL se non è stato specificato l'argomento -MemoryRoutines .
-
MemoryFreeFunction
-
Nome della funzione di callback FreeMemory che PERFLIB chiama per liberare la memoria allocata usando la funzione AllocateMemory . Impostare su NULL se MemoryAllocationFunction è NULL.
-
MemoryFunctionContext
-
Informazioni di contesto da passare all'allocazione di memoria e alle routine libere. Può essere NULL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 7 [solo app desktop] |
Server minimo supportato |
Windows Server 2008 R2 [solo app desktop] |