CounterInitialize-Funktion

Registriert den Anbieter und initialisiert die Indikatorensätze.

Syntax

ULONG WINAPI CounterInitialize(void);

Parameter

Diese Funktion besitzt keine Parameter.

Rückgabewert

Gibt ERROR _ SUCCESS bei Erfolg zurück, andernfalls einen standardmäßigen Win32-Fehlercode.

Hinweise

Ihr Anbieter ruft diese Funktion auf. Die Funktion enthält Aufrufe der PerfStartProvider-Funktion und der PerfSetCounterSetInfo-Funktion.

Das CTRPP-Tool generiert diese Inlinefunktion, wenn Sie das Argument -o angeben. Der Name der Funktion enthält eine Präfixzeichenfolge, wenn Sie das Argument -prefix angeben.

Wenn Sie die Argumente -MemoryRoutines oder -NotificationCallback angeben (oder das Rückrufattribut für das Anbieterelement angeben), ändert sich die CounterInitialize-Signatur wie folgt:

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

Erläuterungen:

NotificationCallback

Der Name ihrer ControlCallback-Rückruffunktion, die Sie implementieren, um Benachrichtigungen über Consumeranforderungen zu erhalten (z. B. Anforderungen zum Hinzufügen oder Entfernen von Leistungsindikatoren aus der Abfrage). Legen Sie auf NULL fest, wenn Sie die ControlCallback-Rückruffunktion nicht implementieren.

MemoryAllocationFunction

Der Name Ihrer AllocateMemory-Rückruffunktion, die PERFLIB aufruft, um Arbeitsspeicher zu belegen. Legen Sie auf NULL fest, wenn Sie das Argument -MemoryRoutines nicht angegeben haben.

MemoryFreeFunction

Der Name Ihrer FreeMemory-Rückruffunktion, die PERFLIB aufruft, um den mit der AllocateMemory-Funktion belegten Arbeitsspeicher freizugeben. Wird auf NULL festgelegt, wenn MemoryAllocationFunction NULL ist.

MemoryFunctionContext

Kontextinformationen, die an Ihre Speicherbelegungs- und freien Routinen übergeben werden sollen. Kann NULL sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server 2008 [ R2-Desktop-Apps]