Partager via


IControlManager

Représente le Gestionnaire de l’enregistreur de performances Windows, qui contrôle le suivi des événements pour les sessions Windows (ETW). Le client transmet une collection de profils à l’aide de l’interface IProfileCollection , et le gestionnaire peut démarrer, mettre à jour, annuler, enregistrer, arrêter ou interroger la session ETW ou les fournisseurs décrits par chaque profil. Le client peut passer un pointeur vers le gestionnaire IControlProgressHandler pour recevoir des mises à jour sur l’opération effectuée par le gestionnaire.

Syntaxe

{
  [propget, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([out, retval] IControlProgressHandler** ppControlProgressHandler);
  [propput, id(1), helpstring("property ControlProgressHandler")] HRESULT ControlProgressHandler
    ([in] IControlProgressHandler* pControlProgressHandler);
  [id(2), helpstring("Start")] HRESULT Start
    ([in] IProfileCollection* pProfileCollection);
  [id(3), helpstring("Update")] HRESULT Update
    ([in] IProfileCollection* pProfileCollection);
  [id(4), helpstring("Cancel")] HRESULT Cancel
    ([in] IProfileCollection* pProfileCollection);
  [id(5), helpstring("Save")] HRESULT Save
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(6), helpstring("Stop")] HRESULT Stop
    ([in] BSTR bstrFileName,
    [in] IProfileCollection* pProfileCollection,
    [in] ITraceMergeProperties* pTraceMergeProperties);
  [id(7), helpstring("QueryXML")] HRESULT QueryXML
    ([out] BSTR* pbstrResults,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [id(8), helpstring("Query")] HRESULT Query
    ([out] IProfileCollection** ppProfileCollection,
    [in] VARIANT_BOOL fValidateRuntimeState);
  [propget, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([out, retval] ITraceMergeTextHandler** ppTraceMergeTextHandler);
  [propput, id(9), helpstring("property TraceMergeTextHandler")] HRESULT TraceMergeTextHandler
    ([in] ITraceMergeTextHandler* pTraceMergeTextHandler);
  [propget, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([out, retval] BSTR* pbstrTemporaryTraceDirectory);
  [propput, id(10), helpstring("property TemporaryTraceDirectory")] HRESULT TemporaryTraceDirectory
    ([in] BSTR bstrTemporaryTraceDirectory);
  [id(11), helpstring("GetProviderNameFromGuid")] HRESULT GetProviderNameFromGuid
    ([out] BSTR* bstrProviderIdStr,
    [in] REFGUID ProviderId);
  [id(12), helpstring("GetProviderGuidFromName")] HRESULT GetProviderGuidFromName
    ([out] GUID* ProviderId,
    [in] BSTR bstrProViderName);
};

Fonctions

Le tableau suivant décrit les fonctions que cette interface fournit.

Fonction Description

Start

Démarre un enregistrement.

Mettre à jour

Mises à jour une collection de profils.

Annuler

Arrête un enregistrement sans enregistrer de données.

Save

Enregistre un enregistrement enregistré dans des mémoires tampons circulaires dans le fichier de journal de trace des événements (ETL) spécifié.

Stop

Arrête un enregistrement et l’enregistre dans le fichier de journal de trace des événements (ETL) spécifié.

QueryXML

Indique le format XML du profil en cours d’exécution et indique si le profil s’exécute correctement.

Requête

Interroge les propriétés de la session et des fournisseurs dans tous les profils.

propget

Obtient la propriété spécifiée.

propput

Définit la propriété spécifiée.

GetProviderNameFromGuid

Obtient le nom du fournisseur du GUID spécifié.

GetProviderGuidFromName

Obtient le GUID du fournisseur du nom spécifié.

Propriétés

Le tableau suivant décrit les paramètres des propriétés que cette interface peut obtenir ou définir.

Propriété Paramètres Description

ControlProgressHandler

ppControlProgressHandler [out]

Pointeur vers l’implémentation côté client de l’interface IControlProgressHandler .

ControlProgressHandler

pControlProgressHandler [in]

Pointeur vers l’implémentation côté client de l’interface IControlProgressHandler . E_POINTER indique un pointeur non valide.

TraceMergeTextHandler

ppTraceMergeTextHandler [out]

Pointeur vers le texte et d’autres informations de temps de fusion dans la trace injectées par l’interface ITraceMergeTextHandler .

TraceMergeTextHandler

pTraceMergeTextHandler [in]

Pointeur vers le texte et d’autres informations de temps de fusion dans la trace injectées par l’interface ITraceMergeTextHandler . E_POINTER indique un pointeur non valide.

TemporaryTraceDirectory

pbstrTemporaryTraceDirectory [out]

Pointeur vers le chemin du répertoire dans lequel les fichiers de trace pré-fusionnés sont consignés. La valeur par défaut est le dossier %temp% .

TemporaryTraceDirectory [in]

bstrTemporaryTraceDirectory

Chemin du répertoire dans lequel les fichiers de trace pré-fusionnés sont enregistrés.

Interfaces