Treibertesttools

Übersicht über die Technologie der Treibertesttools.

Zum Entwickeln von Treibertesttools benötigen Sie die folgenden Header:

• wpprecorder.h

Das Programmierhandbuch finden Sie unter Treibertesttools.

Makros

Titel	BESCHREIBUNG
WppRecorderKonfigurieren des Makros	Die WppRecorderConfigure-Methode aktiviert oder deaktiviert das Standardprotokoll, in das WPP druckt.
WppRecorderDumpLiveDriverData-Makro	Die WppRecorderDumpLiveDriverData-Methode ruft den Puffer ab, der dem angegebenen Inflight Trace Recorder-Protokoll zugeordnet ist.
WppRecorderGetTriageInfo-Makro	The WppRecorderGetTriageInfo.
WppRecorderLinkCounters-Makro	The WppRecorderLinkCounters.
WppRecorderLogMakro erstellen	Die WppRecorderLogCreate-Methode erstellt einen Puffer, der das Aufzeichnungsprotokoll enthält.
WppRecorderLogDelete-Makro	Die WppRecorderLogDelete-Methode löscht das angegebene Aufzeichnungsprotokoll.
WppRecorderLogSetIdentifier-Makro	Die WppRecorderLogSetIdentifier-Methode legt einen Zeichenfolgenbezeichner für das Aufzeichnungsprotokoll fest.

Enumerationen

FAULT_INFORMATION_ARCH Definiert Werte für den Typ der Systemarchitektur.
FAULT_INFORMATION_ARM64_TYPE Definiert Werte für den Fehlertyp.
PCW_CALLBACK_TYPE Die PCW_CALLBACK_TYPE-Enumeration definiert den Benachrichtigungstyp, der an den registrierten Anbieter des Countersets gesendet werden soll. Ein Anbieter übergibt einen Zeiger auf diese Enumeration als Parameter an die PcwCallback-Funktion.
WPP_RECORDER_TRI_STATE Der WPP_RECORDER_TRI_STATE Enumerationstyp definiert drei Werte, die WPP für einige Strukturmember und Funktionsparameter verwendet.

Functions

ASSERTMSG ASSERTMSG testet einen Ausdruck. Wenn der Ausdruck false ist, bricht er in den Kerneldebugger ein und sendet die angegebene Nachricht.
DbgBreakPoint Die DbgBreakPoint-Routine wird in den Kerneldebugger unterteilt.
DbgBreakPointWithStatus Die DbgBreakPointWithStatus-Routine unterteilt sich in den Kerneldebugger und sendet den Wert status an den Debugger.
DbgPrint Die DbgPrint-Routine sendet eine Nachricht an den Kerneldebugger.
DbgPrintEx Die DbgPrintEx-Routine sendet eine Zeichenfolge an den Kerneldebugger, wenn die von Ihnen angegebenen Bedingungen erfüllt sind.
DbgPrompt Die DbgPrompt-Routine zeigt eine vom Aufrufer angegebene Benutzereingabeaufforderungszeichenfolge auf dem Anzeigegerät des Kerneldebuggers an und ruft eine Benutzerantwortzeichenfolge ab.
EtwActivityIdControl Die EtwActivityIdControl-Funktion erstellt, fragt ab und legt den aktuellen Aktivitätsbezeichner fest.
ETWENABLECALLBACK Die EtwEnableCallback-Funktion ist eine optionale vom Treiber bereitgestellte Rückruffunktion, die zum Empfangen von Aktivierungs- oder Deaktivierungsbenachrichtigungen verwendet wird.
EtwEventEnabled Die EtwEventEnabled-Funktion überprüft, ob ein Ereignis aktiviert ist.
EtwProviderEnabled Die EtwProviderEnabled-Funktion überprüft, ob ein Anbieter für die Ereignisprotokollierung auf einer angegebenen Ebene und Schlüsselwort (keyword) aktiviert ist.
EtwRegister Die EtwRegister-Funktion registriert den Ereignisanbieter und muss aufgerufen werden, bevor ein Anbieter die Ablaufverfolgung starten kann.
EtwUnregister Die EtwUnregister-Funktion hebt die Registrierung des Ereignisanbieters auf und muss aufgerufen werden, bevor der Anbieter beendet wird.
EtwWrite Die EtwWrite-Funktion ist eine Ablaufverfolgungsfunktion zum Veröffentlichen von Ereignissen in Ihrem Kernelmodustreibercode.
EtwWriteEx Die EtwWriteEx-Funktion ist eine Ablaufverfolgungsfunktion für die Veröffentlichung von Ereignissen, die die Filterung in Ihrem Kernelmodustreibercode unterstützen.
EtwWriteString Die EventWriteString-Funktion ist eine Ablaufverfolgungsfunktion, die Sie verwenden können, wenn keine anspruchsvollen Daten erforderlich sind. Diese Funktion ähnelt einer Debugdruckanweisung.
EtwWriteTransfer Die EtwWriteTransfer-Funktion markiert ein Ereignis, das zwei Aktivitäten miteinander verknüpft. dieser Ereignistyp wird als Übertragungsereignis bezeichnet.
imp_WppRecorderGetCounterHandle Die WppRecorderGetCounterHandle-Methode.
imp_WppRecorderIsDefaultLogAvailable Die WppRecorderIsDefaultLogAvailable-Methode bestimmt, ob das Standardprotokoll verfügbar ist.
imp_WppRecorderLogGetDefault Die WppRecorderLogGetDefault-Methode ruft ein Handle für das Standardaufzeichnungsprotokoll ab.
KdBreakPointWithStatus Das Makro KdBreakPointWithStatus unterteilt sich in den Kerneldebugger und sendet den Wert status an den Debugger.
KdChangeOption Die KdChangeOption-Routine greift auf den Kernel zu und ändert den Zustand, der sich auf das Kerneldebuggen bezieht.
KdDisableDebugger Die KdDisableDebugger-Routine deaktiviert den Kerneldebugger.
KdEnableDebugger Die KdEnableDebugger-Routine aktiviert den Kerneldebugger erneut, nachdem ein Aufruf der KdDisableDebugger-Routine den Kerneldebugger deaktiviert hat.
KdPrint Das KdPrint-Makro sendet eine Nachricht an den Kerneldebugger.
KdPrintEx Das KdPrintEx-Makro sendet eine Zeichenfolge an den Kerneldebugger, wenn die von Ihnen angegebenen Bedingungen erfüllt sind. Ein Aufruf von KdPrintEx erfordert doppelte Klammern.
KdRefreshDebuggerNotPresent Das Makro KdRefreshDebuggerNotPresent aktualisiert den Wert der globalen Kernelvariable KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Initialisiert ein Datenblockarray des Triageabbilds.
PCW_CALLBACK Anbieter können eine PCW_CALLBACK-Funktion implementieren, um Benachrichtigungen zu empfangen, wenn Consumer bestimmte Aktionen ausführen, z. B. das Hinzufügen oder Entfernen von Indikatoren aus einer Abfrage.
PcwAddInstance Die PcwAddInstance-Funktion fügt dem Consumerpuffer die angegebene instance des Countersets hinzu.
PcwCloseInstance Die PcwCloseInstance-Funktion schließt die angegebene instance des Countersets.
PcwCreateInstance Die PcwCreateInstance-Funktion erstellt eine neue instance für die angegebene registrierte Zählermenge.
PcwRegister Die PcwRegister-Funktion registriert den Aufrufer als Anbieter des angegebenen Countersets.
PcwUnregister Die PcwUnregister-Funktion hebt die Registrierung des Anbieters der angegebenen Leistungsgruppe auf.
RECORDER_CONFIGURE_PARAMS_INIT Die RECORDER_CONFIGURE_PARAMS_INIT-Funktion wird verwendet, um die RECORDER_CONFIGURE_PARAMS-Struktur zu initialisieren.
RECORDER_LOG_CREATE_PARAMS_INIT Die RECORDER_LOG_CREATE_PARAMS_INIT-Funktion wird verwendet, um die RECORDER_LOG_CREATE_PARAMS-Struktur zu initialisieren.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER Die RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER-Methode initialisiert die RECORDER_LOG_CREATE_PARAMS mit dem Zeiger zum Verknüpfen von Protokollen.
SeEtwWriteKMCveEvent Die SeEtwWriteKMCveEvent-Funktion ist eine Ablaufverfolgungsfunktion für die Veröffentlichung von Ereignissen, wenn in Ihren Kernelmodustreibern ein Versuchter Sicherheitsrisiko-Exploit erkannt wird.
vDbgPrintEx Die vDbgPrintEx-Routine sendet eine Zeichenfolge an den Kerneldebugger, wenn bestimmte Bedingungen erfüllt sind.
vDbgPrintExWithPrefix Die vDbgPrintExWithPrefix-Routine sendet eine Zeichenfolge an den Kerneldebugger, wenn bestimmte von Ihnen angegebene Bedingungen erfüllt sind. Diese Routine kann ein Präfix an die Debuggerausgabe anfügen, um debugergebnisse zu organisieren.
WppRecorderConfigure Erfahren Sie, wie die WppRecorderConfigure-Methode das Standardprotokoll aktiviert oder deaktiviert, in dem WPP druckt.
WppRecorderDumpLiveDriverData Erfahren Sie, wie die WppRecorderDumpLiveDriverData-Methode den Puffer abruft, der dem angegebenen Inflight Trace Recorder-Protokoll zugeordnet ist.
WppRecorderGetTriageInfo Erfahren Sie mehr über die WppRecorderGetTriageInfo-Methode.
WppRecorderLinkCounters Erfahren Sie, wie die WppRecorderLinkCounters-Methode eine Sequenznummer verwendet, um Protokolle zusammenzuführen, die von einem Treiber in verschiedenen Puffern erfasst wurden.
WppRecorderLogErstellen Erfahren Sie, wie die WppRecorderLogCreate-Methode einen Puffer erstellt, der das Aufzeichnungsprotokoll enthält.
WppRecorderLogDelete Erfahren Sie, wie die WppRecorderLogDelete-Methode das angegebene Aufzeichnungsprotokoll löscht.
WppRecorderLogDumpLiveData Die WppRecorderLogDumpLiveData-Methode gibt einen undurchsichtigen Zeiger auf einen Protokollpufferheader und Daten zurück, damit sie in einem Liveabsturzdump gespeichert werden können.
WppRecorderLogSetIdentifier Erfahren Sie, wie die WppRecorderLogSetIdentifier-Methode einen Zeichenfolgenbezeichner für das Aufzeichnungsprotokoll festlegt.

Strukturen

DEBUG_DEVICE_DESCRIPTOR Weitere Informationen: DEBUG_DEVICE_DESCRIPTOR-Struktur
DEBUG_TRANSPORT_DATA Beschreibt spezifische Debugtransportdaten für die Verwendung durch den Transport.
FAULT_INFORMATION Enthält Informationen zum Festlegen des Fehlerberichts auf einem Gerät.
FAULT_INFORMATION_ARM64 Enthält Fehlerinformationen für ein ARM64-System.
FAULT_INFORMATION_ARM64_FLAGS Definiert Fehlerinformationen.
KBUGCHECK_CALLBACK_RECORD Weitere Informationen: KBUGCHECK_CALLBACK_RECORD Struktur
KBUGCHECK_REASON_CALLBACK_RECORD Weitere Informationen: KBUGCHECK_REASON_CALLBACK_RECORD-Struktur
KBUGCHECK_REMOVE_PAGES Weitere Informationen: KBUGCHECK_REMOVE_PAGES Struktur
KBUGCHECK_SECONDARY_DUMP_DATA_EX Weitere Informationen: _KBUGCHECK_SECONDARY_DUMP_DATA_EX-Struktur
KBUGCHECK_TRIAGE_DUMP_DATA Weitere Informationen: _KBUGCHECK_TRIAGE_DUMP_DATA-Struktur
KTRIAGE_DUMP_DATA_ARRAY Weitere Informationen: _KTRIAGE_DUMP_DATA_ARRAY Struktur
MCG_CAP Weitere Informationen: MCG_CAP-Struktur
PCW_CALLBACK_INFORMATION Die PCW_CALLBACK_INFORMATION Union liefert Details zur zu sendenden Benachrichtigung. Ein Anbieter übergibt einen Zeiger auf diese Union als Parameter an die PcwCallback-Funktion.
PCW_COUNTER_DESCRIPTOR Die PCW_COUNTER_DESCRIPTOR-Struktur enthält Details zur zu sendenden Benachrichtigung.
PCW_COUNTER_INFORMATION Die PCW_COUNTER_INFORMATION-Struktur beschreibt Attribute, die eine bestimmte instance einer Indikatorenmenge identifizieren.
PCW_DATA Die PCW_DATA-Struktur beschreibt das Array von Datenblöcken, die einem instance zugeordnet sind.
PCW_MASK_INFORMATION Die PCW_MASK_INFORMATION-Struktur enthält Details zur Benachrichtigung, die an den Anbieter gesendet werden soll. Diese Informationen werden als Teil des Info-Parameters an die PcwCallback-Funktion übergeben. Diese Maskeninformationen sind in PCW_CALLBACK_INFORMATION enthalten.
PCW_REGISTRATION_INFORMATION Die PCW_REGISTRATION_INFORMATION-Struktur enthält Details zum Anbieter und zur Zählermenge.
RECORDER_CONFIGURE_PARAMS Die RECORDER_CONFIGURE_PARAMS-Struktur ist ein Eingabeparameter für die WppRecorderConfigure-Methode, um das Standardprotokoll zu aktivieren oder zu deaktivieren, in dem WPP druckt.
RECORDER_LOG_CREATE_PARAMS Die RECORDER_LOG_CREATE_PARAMS-Struktur ist ein Eingabeparameter für die WppRecorderLogCreate-Methode.
WPP_TRIAGE_INFO Wird verwendet, um das WPP-Protokoll für die WER-Berichterstellung zu suchen.