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] |