WPP szoftverkövetés

Ez a szakasz azt ismerteti, hogyan használható a Windows szoftverkövetési előfeldolgozó (WPP) egy szoftverösszetevő (nyomkövetési szolgáltató) működésének nyomon követésére. A nyomkövetési szolgáltató az alábbiak egyike lehet:

  • Kernel módban működő illesztőprogram

  • Felhasználói módú illesztőprogram, alkalmazás vagy dinamikus csatolású kódtár (DLL).

A WPP szoftverkövetés kiegészíti és javítja a WMI-események nyomon követését azáltal, hogy egyszerűbbé teszi a nyomkövetési szolgáltató működésének nyomon követését. A nyomkövetési szolgáltató hatékony mechanizmusa a valós idejű bináris üzenetek naplózására. A naplózott üzenetek ezután átalakíthatók a nyomkövetési szolgáltató műveletének emberi olvasásra alkalmas nyomkövetésére.

Mikor érdemes WPP-szoftverkövetést használni?

A WPP szoftverkövetés elsősorban kód hibakeresésére szolgál a fejlesztés során. Ha olyan eseményeket szeretne közzétenni, amelyeket a strukturált ETW-események iránt érdeklődő alkalmazások használhatnak, a fejlesztés során végzett nyomkövetés mellett használja a következőket:

További információ: Mikor érdemes használni a WPP szoftverkövetést vagy a Windows eseménykövetési (ETW) API-t?

A WPP-szoftverkövetést használó naplózási üzenetek hasonlóak a Windows eseménynaplózási szolgáltatásaihoz. Az illesztőprogram naplózza az üzenetazonosítót és a formázatlan bináris adatokat egy naplófájlban. Ezt követően a postprocesszor a naplófájlban lévő információkat emberi olvasásra alkalmas formátummá alakítja. A WPP-szoftverkövetés azonban támogatja az eseménynaplózási szolgáltatások által támogatottnál alkalmasabb és rugalmasabb üzenetformátumokat. A WPP-szoftverkövetés például beépített támogatást nyújt az IP-címekhez, a grafikus felhasználói felülethez, a rendszerazonosítókhoz, az időbélyegekhez és más hasznos adattípusokhoz. Emellett a felhasználók egyéni adattípusokat is hozzáadhatnak az alkalmazásukhoz.

A WPP szoftverkövetési folyamatának áttekintése

A WPP-szoftverkövetés illesztőprogramhoz vagy alkalmazáshoz való hozzáadásának alapfolyamata az alábbi lépéseket tartalmazza. Ha a WDK-ban megadott Visual Studio-sablonokat használja WDF-illesztő létrehozásához, a munka nagy része az Ön számára történik.

  • Adjon meg egy vezérlő GUID azonosítót, amely egyedileg azonosítja az illesztőprogramot vagy az alkalmazást nyomkövetési szolgáltatóként. A szolgáltató ezt a GUID-t a WPP_CONTROL_GUIDS makró definíciójában, valamint a Tracelog vagy egy másik nyomkövetési vezérlő által használt kapcsolódó vezérlőfájlban adja meg.

  • Adja hozzá a szükséges WPP-hez kapcsolódó C előfeldolgozási irányelveket és WPP-makróhívásokat a szolgáltató forrásfájljaihoz a WPP-szoftverkövetés hozzáadása Windows-illesztőprogramhoz és a WPP-szoftverkövetési referenciaban leírtak szerint.

  • Módosítsa a Visual Studio-projektet úgy, hogy futtassa a WPP-előfeldolgozót, és hozza létre az illesztőprogramot a WPP szoftverkövetés windowsos illesztőprogramhoz való hozzáadásának 6. lépésében leírtak szerint. További összeállítási időlehetőségekért tekintse meg a WPP-előfeldolgozót .

  • Telepítse az illesztőprogramot vagy az összetevőt. Indítsa el a nyomkövetési munkamenetet, és rögzítse a nyomkövetési üzeneteket. A nyomkövetési munkamenetek konfigurálásához, elindításához és leállításához, valamint a nyomkövetési üzenetek megjelenítéséhez és szűréséhez használja a szoftverkövetés eszközeit, például a TraceView, a Tracelog, a Tracefmt és a Tracepdb eszközt. Ezek az eszközök a Windows Driver Kit (WDK) részét képezik.

Ebben a szakaszban

Jegyzet A Windows (ETW) és a WPP eseménykövetése támogatja a legtöbb kernelmódú és felhasználói módú illesztőprogramot. Az ETW és a WPP azonban olyan típusokat használ, amelyek nem érhetők el bizonyos típusú illesztőprogramokhoz, például miniportillesztőkhöz. Annak megállapításához, hogy egy adott illesztőprogramtípus támogatott-e, adjon hozzá alapszintű WPP-makrókat az illesztőprogramhoz, például WPP_INIT_TRACING és WPP_CLEANUP. Ha a kód nem fordítható le, mert a használt típusok nincsenek definiálva, az ETW és a WPP nem tudja támogatni az illesztőprogram típusát.

Az ETW-ről további információt a Windows eseménykövetésében talál.

Jegyzet A WPP-nyomkövetési szolgáltatók egyszerre csak egy nyomkövetési munkamenetben engedélyezhetők. További információkért lásd a WPP-szolgáltatókat .

A WPP-szoftverkövetést támogató WMI-kódtár támogatási rutinjaival kapcsolatos információkért lásd:

WmiQueryTraceInformation

WmiTraceMessage

WmiTraceMessageVa

  • Last updated on