IControlManager

Mewakili manajer Perekam Performa Windows, yang mengontrol sesi Pelacakan Peristiwa untuk Windows (ETW). Klien meneruskan kumpulan profil menggunakan antarmuka IProfileCollection , dan manajer dapat memulai, memperbarui, membatalkan, menyimpan, menghentikan, atau mengkueri sesi atau penyedia ETW yang dijelaskan setiap profil. Klien dapat meneruskan penunjuk ke handler IControlProgressHandler untuk menerima pembaruan tentang operasi yang dilakukan manajer.

Sintaks

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

Fungsi

Tabel berikut menjelaskan fungsi yang disediakan antarmuka ini.

Fungsi	Deskripsi
Mulai	Memulai rekaman.
Pembaruan	Updates koleksi profil.
Batalkan	Menghentikan perekaman tanpa menyimpan data apa pun.
Simpan	Menyimpan rekaman yang dicatat ke buffer melingkar dalam memori ke file log jejak peristiwa (ETL) yang ditentukan.
Stop	Menghentikan perekaman dan menyimpannya ke file log jejak peristiwa (ETL) yang ditentukan.
QueryXML	Menunjukkan format XML dari profil yang sedang berjalan dan apakah profil berjalan dengan benar.
Kueri	Mengkueri properti sesi dan penyedia di semua profil.
propget	Mendapatkan properti yang ditentukan.
propput	Mengatur properti yang ditentukan.
GetProviderNameFromGuid	Mendapatkan nama penyedia GUID yang ditentukan.
GetProviderGuidFromName	Mendapatkan GUID penyedia dari nama yang ditentukan.

Properti

Tabel berikut ini menjelaskan parameter properti yang bisa didapat atau diatur antarmuka ini.

Properti	Parameter	Deskripsi
ControlProgressHandler	ppControlProgressHandler [out]	Arahkan ke implementasi sisi klien antarmuka IControlProgressHandler .
ControlProgressHandler	pControlProgressHandler [in]	Arahkan ke implementasi sisi klien antarmuka IControlProgressHandler . E_POINTER menunjukkan penunjuk yang tidak valid.
TraceMergeTextHandler	ppTraceMergeTextHandler [out]	Arahkan ke teks dan beberapa informasi waktu penggabungan lainnya dalam jejak yang disuntikkan oleh antarmuka ITraceMergeTextHandler .
TraceMergeTextHandler	pTraceMergeTextHandler [in]	Arahkan ke teks dan beberapa informasi waktu penggabungan lainnya dalam jejak yang disuntikkan oleh antarmuka ITraceMergeTextHandler . E_POINTER menunjukkan penunjuk yang tidak valid.
TemporaryTraceDirectory	pbstrTemporaryTraceDirectory [out]	Penunjuk ke jalur direktori tempat file pelacakan yang telah digabungkan sebelumnya dicatat. Defaultnya adalah folder %temp%.
TemporaryTraceDirectory [in]	bstrTemporaryTraceDirectory	Jalur direktori tempat file pelacakan yang telah digabungkan sebelumnya dicatat.

Topik terkait

Antarmuka