Interface ITraceDataCollector (pla.h)

Collecte les événements de trace des fournisseurs inscrits.

Cette interface définit la session de trace. La session démarre lorsque le jeu de collecteurs de données s’exécute. La collection de fournisseurs de données de trace définit les fournisseurs que vous souhaitez activer pour la session lors de l’exécution de la session.

Pour créer ce collecteur de données, appelez la méthode IDataCollectorCollection ::CreateDataCollector ou IDataCollectorCollection ::CreateDataCollectorFromXml . Pour plus d’informations sur le code XML que vous passez à CreateDataCollectorFromXml, consultez Remarques.

Héritage

L’interface ITraceDataCollector hérite de l’interface IDataCollector.

Méthodes

L’interface ITraceDataCollector a ces méthodes.

ITraceDataCollector ::get_BufferSize Récupère ou définit la taille de mémoire tampon suggérée pour chaque mémoire tampon dans la session de suivi d’événements. (Get)
ITraceDataCollector ::get_BuffersLost Récupère le nombre de mémoires tampons qui n’ont pas été écrites dans le fichier journal.
ITraceDataCollector ::get_BuffersWritten Récupère le nombre de mémoires tampons écrites dans le fichier journal.
ITraceDataCollector ::get_ClockType Récupère ou définit la résolution d’horloge à utiliser lors de la journalisation de l’horodatage pour chaque événement. (Get)
ITraceDataCollector ::get_EventsLost Récupère le nombre d’événements qui n’ont pas été écrits dans la mémoire tampon.
ITraceDataCollector ::get_ExtendedModes Récupère ou définit les modes de fichier journal étendus. (Get)
ITraceDataCollector ::get_FlushTimer Récupère ou définit le temps d’attente avant de vider les mémoires tampons. (Get)
ITraceDataCollector ::get_FreeBuffers Récupère le nombre de mémoires tampons allouées mais inutilisées dans le pool de mémoires tampons de la session de suivi d’événements.
ITraceDataCollector ::get_Guid Récupère ou définit le GUID de session. (Get)
ITraceDataCollector ::get_IsKernelTrace Récupère une valeur qui indique si la trace contient des fournisseurs de noyau.
ITraceDataCollector ::get_MaximumBuffers Récupère ou définit le nombre maximal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi d’événements. (Get)
ITraceDataCollector ::get_MinimumBuffers Récupère ou définit le nombre minimal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi d’événements. (Get)
ITraceDataCollector ::get_NumberOfBuffers Récupère ou définit le nombre suggéré de mémoires tampons à utiliser pour la journalisation. (Get)
ITraceDataCollector ::get_PreallocateFile Récupère ou définit une valeur qui indique si PLA doit allouer la taille entière du fichier journal avant la journalisation. (Get)
ITraceDataCollector ::get_ProcessMode Récupère ou définit une valeur qui indique si la session est une session privée in-process. (Get)
ITraceDataCollector ::get_RealTimeBuffersLost Récupère le nombre de mémoires tampons qui n’ont pas été remises en temps réel au consommateur.
ITraceDataCollector ::get_SessionId Récupère l’identificateur de session.
ITraceDataCollector ::get_SessionName Récupère ou définit le nom de la session. (Get)
ITraceDataCollector ::get_SessionThreadId Récupère le thread actuel de la session de journal, si le thread est en cours d’exécution.
ITraceDataCollector ::get_StreamMode Récupère ou définit le mode de journalisation de la session de trace. (Get)
ITraceDataCollector ::get_TraceDataProviders Récupère la liste des fournisseurs activés pour cette session de trace.
ITraceDataCollector ::p ut_BufferSize Récupère ou définit la taille de mémoire tampon suggérée pour chaque mémoire tampon dans la session de suivi d’événements. (Put)
ITraceDataCollector ::p ut_ClockType Récupère ou définit la résolution d’horloge à utiliser lors de la journalisation de l’horodatage pour chaque événement. (Put)
ITraceDataCollector ::p ut_ExtendedModes Récupère ou définit les modes de fichier journal étendus. (Put)
ITraceDataCollector ::p ut_FlushTimer Récupère ou définit le temps d’attente avant de vider les mémoires tampons. (Put)
ITraceDataCollector ::p ut_Guid Récupère ou définit le GUID de session. (Put)
ITraceDataCollector ::p ut_MaximumBuffers Récupère ou définit le nombre maximal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi d’événements. (Put)
ITraceDataCollector ::p ut_MinimumBuffers Récupère ou définit le nombre minimal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi d’événements. (Put)
ITraceDataCollector ::p ut_NumberOfBuffers Récupère ou définit le nombre suggéré de mémoires tampons à utiliser pour la journalisation. (Put)
ITraceDataCollector ::p ut_PreallocateFile Récupère ou définit une valeur qui indique si PLA doit allouer la taille entière du fichier journal avant la journalisation. (Put)
ITraceDataCollector ::p ut_ProcessMode Récupère ou définit une valeur qui indique si la session est une session privée in-process. (Put)
ITraceDataCollector ::p ut_SessionName Récupère ou définit le nom de la session. (Put)
ITraceDataCollector ::p ut_StreamMode Récupère ou définit le mode de journalisation de la session de trace. (Put)

Remarques

L’exemple suivant montre le code XML que vous pouvez utiliser pour initialiser cet objet si vous appelez la méthode IDataCollectorCollection ::CreateDataCollectorFromXml pour le créer. La propriété IDataCollector ::Xml retourne également ce code XML.

<TraceDataCollector>
    <BufferSize/>
    <BuffersLost/>  <!-- Output only -->
    <BuffersWritten/>  <!-- Output only -->
    <ClockType/>
    <EventsLost/>  <!-- Output only -->
    <ExtendedMode/>
    <FlushTimer/>
    <FreeBuffers/>  <!-- Output only -->
    <Guid/>
    <IsKernelTrace/>
    <MaximumBuffers/>
    <MinimumBuffers/>
    <NumberOfBuffers/>
    <PreallocateFile/>
    <ProcessMode/>
    <RealTimeBuffersLost/>  <!-- Output only -->
    <SessionId/>  <!-- Output only -->
    <SessionName/>
    <SessionThreadId/>  <!-- Output only -->
    <StreamMode/>
    <TraceDataProvider>  <!-- Specify for each provider -->
        <DisplayName/>
        <FilterData/>
        <FilterType/>
        <Guid/>
        <KeywordsAll>
            <Description/>
            <ValueMapType/>
            <Value/>
        </KeywordsAll>
        <KeywordsAny>
            <Description/>
            <ValueMapType/>
            <Value/>
        <KeywordsAny/>
        <Level>
            <Description/>
            <ValueMapType/>
            <Value/>
        <Level/>
        <Properties/>
    </TraceDataProvider>
</TraceDataCollector>

Notez que l’exemple n’affiche pas les éléments de propriété hérités d’IDataCollector que vous devez également spécifier.

Lorsque vous spécifiez le code XML pour créer le collecteur, vous pouvez spécifier uniquement les éléments pour les propriétés que vous souhaitez définir. Si vous ne spécifiez pas de propriété, PLA fournit une valeur par défaut. Lorsque vous récupérez le code XML du collecteur, le code XML fournit tous les éléments, y compris ceux de IDataCollector.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pla.h

Voir aussi

IDataCollector