Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
W tej sekcji opisano sposób użycia preprocesora śledzenia oprogramowania systemu Windows (WPP) do śledzenia działania składnika oprogramowania (dostawcy śledzenia). Dostawca śledzenia może być jednym z następujących elementów:
Sterownik trybu jądra.
Sterownik trybu użytkownika, aplikacja lub biblioteka dynamic-link (DLL).
Program WPP uzupełnia i ulepsza śledzenie zdarzeń WMI, oferując sposoby na uproszczenie śledzenia działania dostawcy śledzenia. Jest to wydajny mechanizm rejestrowania komunikatów binarnych w czasie rzeczywistym przez dostawcę śledzenia. Zarejestrowane komunikaty można następnie przekonwertować na czytelny dla człowieka ślad operacji dostawcy śledzenia.
| Kiedy należy używać funkcji śledzenia oprogramowania WPP? |
|---|
Śledzenie oprogramowania WPP jest przeznaczone głównie do debugowania kodu podczas programowania. Jeśli chcesz publikować zdarzenia, które mogą być używane przez aplikacje zainteresowane ustrukturyzowanymi zdarzeniami ETW, oprócz śledzenia podczas programowania, użyj następujących elementów:
|
Rejestrowanie komunikatów za pomocą śledzenia oprogramowania WPP jest podobne do korzystania z usług rejestrowania zdarzeń systemu Windows. Sterownik rejestruje identyfikator komunikatu i niesformatowane dane binarne w pliku dziennika. Następnie program postprocesor konwertuje informacje w pliku dziennika na postać czytelną dla człowieka. Śledzenie oprogramowania WPP obsługuje formaty komunikatów, które są bardziej zaawansowane i elastyczne niż te obsługiwane przez usługi rejestrowania zdarzeń. Na przykład śledzenie oprogramowania WPP ma wbudowaną obsługę adresów IP, identyfikatorów GUID, identyfikatorów systemowych, sygnatur czasowych i innych przydatnych typów danych. Ponadto użytkownicy mogą dodawać niestandardowe typy danych istotne dla swojej aplikacji.
Omówienie procesu śledzenia oprogramowania WPP
Podstawowy proces dodawania śledzenia oprogramowania WPP do sterownika lub aplikacji obejmuje następujące kroki. Jeśli używasz jednego z szablonów programu Visual Studio dostępnych w zestawie WDK do tworzenia sterownika WDF, większość pracy zostaje wykonana.
Zdefiniuj identyfikator GUID kontrolki, który jednoznacznie identyfikuje sterownik lub aplikację jako dostawcę śledzenia. Dostawca określa ten identyfikator GUID w definicji makra WPP_CONTROL_GUIDS i w powiązanym pliku kontrolnym używanym przez Tracelog lub inny Kontroler Śledzenia.
Dodaj wymagane dyrektywy preprocesora C związane z funkcją śledzenia oprogramowania WPP oraz wywołania makr WPP do plików źródłowych dostawcy, zgodnie z opisem w temacie Dodawanie funkcji śledzenia oprogramowania WPP do sterownika systemu Windows i w temacie Dokumentacja referencyjna śledzenia oprogramowania WPP.
Zmodyfikuj projekt programu Visual Studio, aby uruchomić preprocesor programu WPP i skompilować sterownik, zgodnie z opisem w kroku 6 sekcji Dodawanie śledzenia oprogramowania WPP do sterownika systemu Windows. Aby uzyskać więcej opcji czasu kompilacji, możesz zapoznać się z preprocesorem programu WPP .
Zainstaluj sterownik lub składnik. Rozpocznij sesję śledzenia i zarejestruj komunikaty śledzenia. Narzędzia do śledzenia oprogramowania, takie jak TraceView, Tracelog, Tracefmt i Tracepdb , umożliwiają konfigurowanie, uruchamianie i zatrzymywanie sesji śledzenia oraz wyświetlanie i filtrowanie komunikatów śledzenia. Te narzędzia są dołączone do zestawu Windows Driver Kit (WDK).
W tym dziale
- Dodawanie funkcji śledzenia oprogramowania WPP do sterownika systemu Windows
- Narzędzie Inflight Trace Recorder do rejestrowania śladów
- Używanie funkcji śledzenia oprogramowania WPP w dostawcy śledzenia
- Dodawanie makr WPP do źródła śledzenia
- Preprocesor WPP
- Śledzenie i diagnostyka sterowników WDF
Uwaga Śledzenie zdarzeń dla systemu Windows (ETW) i WPP obsługuje większość typów sterowników trybu jądra i trybu użytkownika. Jednak ETW i WPP używają typów, które nie są dostępne w przypadku niektórych sterowników, takich jak sterowniki miniportowe. Aby określić, czy dany typ sterownika jest obsługiwany, dodaj do sterownika podstawowe makra WPP, takie jak WPP_INIT_TRACING i WPP_CLEANUP. Jeśli kod nie jest kompilowany, ponieważ używane typy nie są zdefiniowane, ETW i WPP nie mogą obsługiwać typu sterownika.
Aby uzyskać więcej informacji na temat funkcji ETW, zobacz Śledzenie zdarzeń dla systemu Windows.
Uwaga Dostawcy śledzenia programu WPP mogą być włączeni tylko przez jedną sesję śledzenia jednocześnie. Aby uzyskać więcej informacji, zobacz Dostawcy programu WPP .
Aby uzyskać informacje na temat procedur obsługi biblioteki WMI, które obsługują śledzenie oprogramowania WPP, zobacz: