Compartilhar via


Função PerfStartProviderEx (perflib.h)

Registra o provedor.

Sintaxe

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

Parâmetros

[in] ProviderGuid

GUID que identifica exclusivamente o provedor. O atributo providerGuid do elemento provider especifica o GUID.

[in, optional] ProviderContext

Uma estrutura PERF_PROVIDER_CONTEXT que contém ponteiros para o retorno de chamada de controle, rotinas de gerenciamento de memória e informações de contexto.

[out] Provider

Manipule para o provedor. Você deve chamar PerfStopProvider para liberar recursos associados ao identificador.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

A função CounterInitialize chama essa função; não chame essa função diretamente.

Windows Vista: A função PerfAutoInitialize chama essa função.

A ferramenta CTRPP inclui essa função em vez de PerfStartProvider se você usar o argumento -MemoryRoutines ou o argumento -NotificationCallback ao chamar CTRPP ou se o atributo de retorno de chamada do elemento do provedor estiver definido como "personalizado".

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho perflib.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

PerfStopProvider