Herramientas de prueba de controladores

Artículo
03/09/2023

Información general sobre la tecnología de herramientas de prueba de controladores.

Para desarrollar herramientas de prueba de controladores, necesita estos encabezados:

wpprecorder.h

Para obtener la guía de programación, consulte Herramientas de prueba de controladores.

Macros

Título	Descripción
Macro WppRecorderConfigure	El método WppRecorderConfigure habilita o deshabilita el registro predeterminado en el que WPP imprime.
Macro WppRecorderDumpLiveDriverData	El método WppRecorderDumpLiveDriverData obtiene el búfer asociado al registro especificado de La grabadora de seguimiento de la luz.
Macro WppRecorderGetTriageInfo	The WppRecorderGetTriageInfo.
Macro WppRecorderLinkCounters	The WppRecorderLinkCounters.
Macro WppRecorderLogCreate	El método WppRecorderLogCreate crea un búfer para contener el registro de la grabadora.
Macro WppRecorderLogDelete	El método WppRecorderLogDelete elimina el registro de grabadora especificado.
Macro WppRecorderLogSetIdentifier	El método WppRecorderLogSetIdentifier establece un identificador de cadena para el registro de la grabadora.

Enumeraciones


FAULT_INFORMATION_ARCH Define valores para el tipo de arquitectura del sistema.
FAULT_INFORMATION_ARM64_TYPE Define valores para el tipo de error.
PCW_CALLBACK_TYPE La enumeración PCW_CALLBACK_TYPE define el tipo de notificación que se va a enviar al proveedor registrado del conjunto de contadores. Un proveedor pasa un puntero a esta enumeración como parámetro a la función PcwCallback.
WPP_RECORDER_TRI_STATE El tipo de enumeración WPP_RECORDER_TRI_STATE define tres valores que WPP usa para algunos miembros de estructura y parámetros de función.

Functions


ASSERTMSG ASSERTMSG prueba una expresión. Si la expresión es false, se divide en el depurador de kernel y la envía el mensaje especificado.
DbgBreakPoint La rutina DbgBreakPoint se divide en el depurador de kernel.
DbgBreakPointWithStatus La rutina DbgBreakPointWithStatus se divide en el depurador de kernel y envía el valor de Status al depurador.
DbgPrint La rutina DbgPrint envía un mensaje al depurador de kernel.
DbgPrintEx La rutina DbgPrintEx envía una cadena al depurador de kernel si se cumplen las condiciones especificadas.
DbgPrompt La rutina DbgPrompt muestra una cadena de solicitud de usuario especificada por el autor de la llamada en el dispositivo de visualización del depurador del kernel y obtiene una cadena de respuesta del usuario.
EtwActivityIdControl La función EtwActivityIdControl crea, consulta y establece el identificador de actividad actual.
ETWENABLECALLBACK La función EtwEnableCallback es una función opcional de devolución de llamada proporcionada por el controlador que se usa para recibir notificaciones de habilitación o deshabilitación.
EtwEventEnabled La función EtwEventEnabled comprueba si un evento está habilitado.
EtwProviderEnabled La función EtwProviderEnabled comprueba que un proveedor está habilitado para el registro de eventos en un nivel y una palabra clave especificados.
EtwRegister La función EtwRegister registra el proveedor de eventos y se debe llamar para que un proveedor pueda iniciar el seguimiento.
EtwUnregister La función EtwUnregister anula el registro del proveedor de eventos y se debe llamar antes de que se cierre el proveedor.
EtwWrite La función EtwWrite es una función de seguimiento para publicar eventos en el código del controlador en modo kernel.
EtwWriteEx La función EtwWriteEx es una función de seguimiento para publicar eventos que admiten el filtrado en el código del controlador en modo kernel.
EtwWriteString La función EventWriteString es una función de seguimiento que se puede usar cuando no se requieren datos sofisticados. Esta función es similar a una instrucción de impresión de depuración.
EtwWriteTransfer La función EtwwriteTransfer marca un evento que vincula dos actividades; este tipo de evento se conoce como evento de transferencia.
imp_WppRecorderGetCounterHandle El método WppRecorderGetCounterHandle.
imp_WppRecorderIsDefaultLogAvailable El método WppRecorderIsDefaultLogAvailable determina si el registro predeterminado está disponible.
imp_WppRecorderLogGetDefault El método WppRecorderLogGetDefault obtiene un identificador para el registro de grabadora predeterminado.
KdBreakPointWithStatus La macro KdBreakPointWithStatus se divide en el depurador de kernel y envía el valor de Status al depurador.
KdChangeOption La rutina KdChangeOption tiene acceso y cambia el estado en el kernel relacionado con la depuración del kernel.
KdDisableDebugger La rutina KdDisableDebugger deshabilita el depurador de kernel.
KdEnableDebugger La rutina KdEnableDebugger vuelve a habilitar el depurador de kernel después de una llamada a la rutina KdDisableDebugger deshabilita el depurador de kernel.
KdPrint La macro KdPrint envía un mensaje al depurador de kernel.
KdPrintEx La macro KdPrintEx envía una cadena al depurador de kernel si se cumplen las condiciones especificadas. Una llamada a KdPrintEx requiere paréntesis dobles.
KdRefreshDebuggerNotPresent La macro KdRefreshDebuggerNotPresent actualiza el valor de la variable de kernel global KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Inicializa una matriz de bloques de datos de volcado de prioridades.
PCW_CALLBACK Los proveedores pueden implementar una función de PCW_CALLBACK para recibir notificaciones cuando los consumidores realizan determinadas acciones, como agregar o quitar contadores de una consulta.
PcwAddInstance La función PcwAddInstance agrega la instancia especificada del conjunto de contadores al búfer del consumidor.
PcwCloseInstance La función PcwCloseInstance cierra la instancia especificada del conjunto de contadores.
PcwCreateInstance La función PcwCreateInstance crea una nueva instancia para el conjunto de contadores registrado especificado.
PcwRegister La función PcwRegister registra el autor de la llamada como proveedor del conjunto de contadores especificado.
PcwUnregister La función PcwUnregister anula el registro del proveedor del conjunto de contadores especificado.
RECORDER_CONFIGURE_PARAMS_INIT La función RECORDER_CONFIGURE_PARAMS_INIT se usa para inicializar la estructura de RECORDER_CONFIGURE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT La función RECORDER_LOG_CREATE_PARAMS_INIT se usa para inicializar la estructura de RECORDER_LOG_CREATE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER El método RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER inicializa el RECORDER_LOG_CREATE_PARAMS con el puntero para vincular los registros.
SeEtwwriteKMCveEvent La función SeEtwriteKMCveEvent es una función de seguimiento para publicar eventos cuando se detecta una vulnerabilidad de seguridad intentada en los controladores en modo kernel.
vDbgPrintEx La rutina vDbgPrintEx envía una cadena al depurador de kernel si se cumplen ciertas condiciones.
vDbgPrintExWithPrefix La rutina vDbgPrintExWithPrefix envía una cadena al depurador de kernel si se cumplen determinadas condiciones especificadas. Esta rutina puede anexar un prefijo a la salida del depurador para ayudar a organizar los resultados de la depuración.
WppRecorderConfigure Obtenga información sobre cómo el método WppRecorderConfigure habilita o deshabilita el registro predeterminado en el que se imprime WPP.
WppRecorderDumpLiveDriverData Obtenga información sobre cómo el método WppRecorderDumpLiveDriverData obtiene el búfer asociado al registro especificado de La grabadora de seguimiento de la luz.
WppRecorderGetTriageInfo Obtenga información sobre el método WppRecorderGetTriageInfo.
WppRecorderLinkCounters Obtenga información sobre cómo el método WppRecorderLinkCounters usa un número de secuencia para combinar registros capturados en diferentes búferes por un controlador.
WppRecorderLogCreate Obtenga información sobre cómo el método WppRecorderLogCreate crea un búfer para contener el registro de la grabadora.
WppRecorderLogDelete Obtenga información sobre cómo el método WppRecorderLogDelete elimina el registro de grabadora especificado.
WppRecorderLogDumpLiveData El método WppRecorderLogDumpLiveData devuelve un puntero opaco a un encabezado y datos del búfer de registro para que se puedan guardar en un bloqueo activo.
WppRecorderLogSetIdentifier Obtenga información sobre cómo el método WppRecorderLogSetIdentifier establece un identificador de cadena para el registro de la grabadora.

Estructuras


DEBUG_DEVICE_DESCRIPTOR Más información sobre: estructura de DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Describe los datos específicos del transporte de depuración para su uso por el transporte.
FAULT_INFORMATION Contiene información para establecer el informe de errores en un dispositivo.
FAULT_INFORMATION_ARM64 Contiene información de error para un sistema ARM64.
FAULT_INFORMATION_ARM64_FLAGS Define la información de error.
KBUGCHECK_CALLBACK_RECORD Más información sobre: estructura de KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD Más información sobre: estructura de KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES Más información sobre: estructura de KBUGCHECK_REMOVE_PAGES
KBUGCHECK_SECONDARY_DUMP_DATA_EX Más información sobre: estructura de _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA Más información sobre: estructura de _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY Más información sobre: estructura de _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP Más información sobre: estructura de MCG_CAP
PCW_CALLBACK_INFORMATION El PCW_CALLBACK_INFORMATION unión proporciona detalles sobre la notificación que se va a enviar. Un proveedor pasa un puntero a esta unión como parámetro a la función PcwCallback.
PCW_COUNTER_DESCRIPTOR La estructura PCW_COUNTER_DESCRIPTOR proporciona detalles sobre la notificación que se va a enviar.
PCW_COUNTER_INFORMATION La estructura PCW_COUNTER_INFORMATION describe los atributos que identifican una instancia específica de un conjunto de contadores.
PCW_DATA La estructura PCW_DATA describe la matriz de bloques de datos asociados a una instancia de .
PCW_MASK_INFORMATION La estructura PCW_MASK_INFORMATION proporciona detalles sobre la notificación que se va a enviar al proveedor. Esta información se pasa como parte del parámetro Info a la función PcwCallback. Esta información de máscara se incluye en PCW_CALLBACK_INFORMATION.
PCW_REGISTRATION_INFORMATION La estructura PCW_REGISTRATION_INFORMATION proporciona detalles sobre el proveedor y el conjunto de contadores.
RECORDER_CONFIGURE_PARAMS La estructura RECORDER_CONFIGURE_PARAMS es un parámetro de entrada para el método WppRecorderConfigure para habilitar o deshabilitar el registro predeterminado en el que wpP imprime.
RECORDER_LOG_CREATE_PARAMS La estructura RECORDER_LOG_CREATE_PARAMS es un parámetro de entrada para el método WppRecorderLogCreate.
WPP_TRIAGE_INFO Se usa para buscar el registro de WPP para los informes de WER.

Compartir a través de

Herramientas de prueba de controladores

Macros

Enumeraciones

Functions

Estructuras

Comentarios

Recursos adicionales