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]