IControlManager

Stellt den Windows Performance Recorder-Manager dar, der die Ereignisablaufverfolgung für Windows-Sitzungen (Event Tracing for Windows, ETW) steuert. Der Client übergibt eine Sammlung von Profilen mithilfe der IProfileCollection-Schnittstelle, und der Manager kann die ETW-Sitzung oder -Anbieter starten, aktualisieren, abbrechen, speichern, beenden oder abfragen, die/der jedes Profil beschreibt bzw. beschreiben. Der Client kann einen Zeiger an den IControlProgressHandler-Handler übergeben, um Updates über den Vorgang zu erhalten, den der Manager ausführt.

Syntax

{
  [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);
};

Functions

In der folgenden Tabelle werden die Funktionen beschrieben, die diese Schnittstelle bereitstellt.

Funktion	Beschreibung
Starten	Startet eine Aufzeichnung.
Update	Aktualisiert eine Profilsammlung.
Abbrechen	Beendet eine Aufzeichnung, ohne Daten zu speichern.
Speichern	Speichert eine Aufzeichnung, die an Zirkelpuffern im Arbeitsspeicher protokolliert wird, in der angegebenen Ereignisablaufverfolgungsprotokolldatei (ETL).
Beenden	Beendet eine Aufzeichnung und speichert sie in der angegebenen Ereignisablaufverfolgungsprotokoll-Datei (ETL).
QueryXML	Gibt das XML-Format des aktuell ausgeführten Profils an, und ob das Profil ordnungsgemäß ausgeführt wird.
Abfrage	Fragt die Eigenschaften von Sitzung und Anbietern in allen Profilen ab.
propget	Ruft die angegebene Eigenschaft ab.
propput	Legt die angegebene Eigenschaft fest.
GetProviderNameFromGuid	Ruft den Anbieternamen der angegebenen GUID ab.
GetProviderGuidFromName	Ruft die Anbieter-GUID des angegebenen Namens ab.

Eigenschaften

In der folgenden Tabelle werden die Parameter von Eigenschaften beschrieben, die diese Schnittstelle abrufen oder festlegen kann.

Eigenschaft	Parameter	Beschreibung
ControlProgressHandler	ppControlProgressHandler [aus]	Zeiger auf die clientseitige Implementierung der IControlProgressHandler-Schnittstelle.
ControlProgressHandler	pControlProgressHandler [ein]	Zeiger auf die clientseitige Implementierung der IControlProgressHandler-Schnittstelle. E_POINTER gibt einen ungültigen Zeiger an.
TraceMergeTextHandler	ppTraceMergeTextHandler [aus]	Zeiger auf den Text und einige andere Mergezeitinformationen in der Ablaufverfolgung, die von der ITraceMergeTextHandler-Schnittstelle eingefügt werden.
TraceMergeTextHandler	pTraceMergeTextHandler [ein]	Zeiger auf den Text und einige andere Mergezeitinformationen in der Ablaufverfolgung, die von der ITraceMergeTextHandler-Schnittstelle eingefügt werden. E_POINTER gibt einen ungültigen Zeiger an.
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [aus]	Zeiger auf den Pfad des Verzeichnisses, in dem die vorab zusammengeführten Ablaufverfolgungsdateien protokolliert werden. Der Standard ist der Ordner „%temp%“.
TemporaryTraceDirectory [ein]	bstrTemporaryTraceDirectory	Pfad des Verzeichnisses, in dem die vorab zusammengeführten Ablaufverfolgungsdateien protokolliert werden.

Zugehörige Themen

Schnittstellen