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.

Rubriques connexes

Interfaces