Freigeben über


Treibertesttools

Übersicht über die Technologie der Treibertesttools.

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

Die Programmieranleitung finden Sie unter Treibertesttools.

Makros

Titel BESCHREIBUNG
WppRecorderConfigure-Makro Die WppRecorderConfigure-Methode aktiviert oder deaktiviert das Standardprotokoll, in das WPP gedruckt wird.
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.
WppRecorderLogCreate-Makro 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-Aufzählung definiert den Benachrichtigungstyp, der an den registrierten Anbieter der Gegenmenge 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 Strukturmmber und Funktionsparameter verwendet.

Funktionen

 
ASSERTMSG-

ASSERTMSG testet einen Ausdruck. Wenn der Ausdruck "false" ist, wird er in den Kerneldebugger umgebrochen und sendet sie an die angegebene Nachricht.
DbgBreakPoint-

Die DbgBreakPoint-Routine unterbricht in den Kerneldebugger.
DbgBreakPointWithStatus-

Die DbgBreakPointWithStatus-Routine wechselt in den Kerneldebugger und sendet den Wert von 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 Benutzeraufforderungszeichenfolge auf dem Anzeigegerät des Kerneldebuggers an und ruft eine Benutzerantwortzeichenfolge ab.
EtwActivityIdControl-

Die EtwActivityIdControl-Funktion erstellt, fragt und legt den aktuellen Aktivitätsbezeichner fest.
ETWENABLECALLBACK-

Die EtwEnableCallback-Funktion ist eine optionale vom Treiber bereitgestellte Rückruffunktion, die verwendet wird, um Benachrichtigungen zu aktivieren oder zu deaktivieren.
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 einem Schlüsselwort 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 im Kernelmodustreibercode.
EtwWriteEx-

Die EtwWriteEx-Funktion ist eine Ablaufverfolgungsfunktion zum Veröffentlichen von Ereignissen, die das Filtern im Kernelmodustreibercode unterstützen.
EtwWriteString-

Die EventWriteString-Funktion ist eine Ablaufverfolgungsfunktion, die Sie verwenden können, wenn keine komplexen Daten erforderlich sind. Diese Funktion ähnelt einer Debugdruck-Anweisung.
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 KdBreakPointWithStatus-Makro wechselt in den Kerneldebugger und sendet den Wert von Status an den Debugger.
KdChangeOption-

Die KdChangeOption-Routine greift auf den Kernel zu und ändert den Zustand im Kernel, der mit dem Kerneldebugging verknüpft ist.
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 KdRefreshDebuggerNotPresent-Makro aktualisiert den Wert der globalen Kernelvariable KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray

Initialisiert ein Triage-Speicherabbild-Datenblockarray.
PCW_CALLBACK

Anbieter können eine PCW_CALLBACK-Funktion implementieren, um Benachrichtigungen zu empfangen, wenn Verbraucher bestimmte Aktionen ausführen, z. B. das Hinzufügen oder Entfernen von Zählern aus einer Abfrage.
PcwAddInstance

Die PcwAddInstance-Funktion fügt die angegebene Instanz des Gegensatzs zum Consumerpuffer hinzu.
PcwCloseInstance

Die PcwCloseInstance-Funktion schließt die angegebene Instanz des Gegensatzs.
PcwCreateInstance-

Die PcwCreateInstance-Funktion erstellt eine neue Instanz für die angegebene registrierte Gegenmenge.
PcwRegister-

Die PcwRegister-Funktion registriert den Aufrufer als Anbieter der angegebenen Gegenmenge.
PcwUnregister-

Die PcwUnregister-Funktion hebt die Registrierung des Anbieters der angegebenen Gegenmenge 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, um Protokolle zu verknüpfen.
SeEtwriteKMCveEvent

Die SeEtwriteKMCveEvent-Funktion ist eine Ablaufverfolgungsfunktion zum Veröffentlichen von Ereignissen, wenn ein versuchter Sicherheitsrisiko-Exploit in Ihren Kernelmodustreibern 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 Debuggingergebnisse zu organisieren.
WppRecorderConfigure-

Erfahren Sie, wie die WppRecorderConfigure-Methode das Standardprotokoll aktiviert oder deaktiviert, in das WPP gedruckt wird.
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 zum Zusammenführen von Protokollen verwendet, die in verschiedenen Puffern von einem Treiber erfasst wurden.
WppRecorderLogCreate

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 zu: DEBUG_DEVICE_DESCRIPTOR Struktur
DEBUG_TRANSPORT_DATA

Beschreibt debug-transportspezifische Daten 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 zu: KBUGCHECK_CALLBACK_RECORD Struktur
KBUGCHECK_REASON_CALLBACK_RECORD

Weitere Informationen zu: KBUGCHECK_REASON_CALLBACK_RECORD Struktur
KBUGCHECK_REMOVE_PAGES

Beschreibt eine oder mehrere Seiten von vom Treiber bereitgestellten Daten, die von einer KBUGCHECK_REASON_CALLBACK_ROUTINE Rückrufroutine aus der Absturzabbilddatei entfernt werden sollen.
KBUGCHECK_SECONDARY_DUMP_DATA_EX

Weitere Informationen zu: _KBUGCHECK_SECONDARY_DUMP_DATA_EX Struktur
KBUGCHECK_TRIAGE_DUMP_DATA

Weitere Informationen zu: _KBUGCHECK_TRIAGE_DUMP_DATA Struktur
KTRIAGE_DUMP_DATA_ARRAY

Weitere Informationen zu: _KTRIAGE_DUMP_DATA_ARRAY Struktur
MCG_CAP

Weitere Informationen zu: MCG_CAP Struktur
PCW_CALLBACK_INFORMATION

Die PCW_CALLBACK_INFORMATION Union liefert Details zur zu sendenden Benachrichtigung. Ein Anbieter übergibt einen Zeiger als Parameter an diese Union 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 Instanz einer Gegenmenge identifizieren.
PCW_DATA

Die PCW_DATA Struktur beschreibt das Array von Datenblöcken, die einer Instanz 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 liefert Details zum Anbieter und zum Gegensatz.
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 gedruckt wird.
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 finden.