Função ProcessTraceBufferIncrementReference (evntrace.h)
Chamado durante o BufferCallback no Buffer fornecido para evitar que ele seja liberado até que o chamador seja concluído com ele.
Sintaxe
ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceBufferIncrementReference(
PROCESSTRACE_HANDLE TraceHandle,
const ETW_BUFFER_HEADER *Buffer
);
Parâmetros
TraceHandle
A sessão de processamento da qual esse Buffer veio.
Buffer
O buffer a ser referenciado. Esse buffer deve ter sido obtido por uma chamada para o retorno de chamada PETW_BUFFER_CALLBACK.
Retornar valor
Código de erro Win32. Os códigos possíveis podem incluir ERROR_INVALID_PARAMETER e ERROR_OUTOFMEMORY.
Comentários
Se ProcessTraceBufferIncrementReference não for chamado em um Buffer durante o PETW_BUFFER_CALLBACK , a memória não estará mais acessível após o retorno da PETW_BUFFER_CALLBACK .
O chamador é responsável por chamar ProcessTraceBufferDecrementReference no Buffer depois de terminar com ele. ProcessTrace não retornará até que isso tenha sido feito para cada buffer que foi incrementado.
ProcessTraceBufferIncrementReference não tem suporte para buffers fornecidos por uma sessão de processamento aberta por OpenTraceFromBufferStream.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | evntrace.h |
Biblioteca | Sechost.lib em Windows 8.1 e Windows Server 2012 R2; Advapi32.lib em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP |
DLL | Sechost.dll em Windows 8.1 e Windows Server 2012 R2; Advapi32.dll em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de