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 |
---|---|
Démarre un enregistrement. |
|
Mises à jour une collection de profils. |
|
Arrête un enregistrement sans enregistrer de données. |
|
Enregistre un enregistrement enregistré dans des mémoires tampons circulaires dans le fichier de journal de trace des événements (ETL) spécifié. |
|
Arrête un enregistrement et l’enregistre dans le fichier de journal de trace des événements (ETL) spécifié. |
|
Indique le format XML du profil en cours d’exécution et indique si le profil s’exécute correctement. |
|
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. |
Obtient le nom du fournisseur du GUID spécifié. |
|
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. |