Freigeben über

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.

Schnittstellen

  • Last updated on