PerfStartProviderEx-Funktion (perflib.h)

  • Artikel

Registriert den Anbieter.

Syntax

ULONG PerfStartProviderEx(
  [in]           LPGUID                 ProviderGuid,
  [in, optional] PPERF_PROVIDER_CONTEXT ProviderContext,
  [out]          PHANDLE                Provider
);

Parameter

[in] ProviderGuid

GUID, die den Anbieter eindeutig identifiziert. Das providerGuid-Attribut des provider-Elements gibt die GUID an.

[in, optional] ProviderContext

Eine PERF_PROVIDER_CONTEXT-Struktur , die Zeiger auf den Steuerelementrückruf, Speicherverwaltungsroutinen und Kontextinformationen enthält.

[out] Provider

Handle an den Anbieter. Sie müssen PerfStopProvider aufrufen, um ressourcen freizugeben, die dem Handle zugeordnet sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.

Hinweise

Die CounterInitialize-Funktion ruft diese Funktion auf; rufen Sie diese Funktion nicht direkt auf.

Windows Vista: Die PerfAutoInitialize-Funktion ruft diese Funktion auf.

Das CTRPP-Tool enthält diese Funktion anstelle von PerfStartProvider, wenn Sie beim Aufrufen von CTRPP das Argument -MemoryRoutines oder -NotificationCallback-Argument verwenden oder wenn das Rückrufattribut des anbieterelements auf "custom" festgelegt ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile perflib.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

PerfStopProvider