Share via

Información general sobre el seguimiento de eventos USB para Windows

  • Artículo

En este tema se proporciona información para los desarrolladores de controladores de cliente sobre las características de seguimiento y registro de Universal Serial Bus (USB). Esta información se proporciona para las ventajas de aquellos que desarrollan y depuran dispositivos USB. Incluye información sobre cómo instalar las herramientas, crear archivos de seguimiento y analizar los eventos en un archivo de seguimiento USB. En el tema se da por supuesto que tiene un conocimiento completo del ecosistema y el hardware USB necesarios para usar correctamente las características de seguimiento y registro de USB.

Para interpretar los seguimientos de eventos, también debe comprender los controladores del lado host USB de Windows, las especificaciones USB oficiales y las especificaciones de clase de dispositivo USB.

Acerca del seguimiento de eventos para Windows

Seguimiento de eventos para Windows (ETW) es una instalación de seguimiento de alta velocidad y de uso general proporcionada por el sistema operativo. Usa un mecanismo de almacenamiento en búfer y registro que se implementa en el kernel para proporcionar un mecanismo de seguimiento para los eventos que generan las aplicaciones en modo de usuario y los controladores de dispositivos en modo kernel. Además, ETW proporciona la capacidad de habilitar y deshabilitar dinámicamente el registro, lo que facilita el seguimiento detallado en entornos de producción sin necesidad de reinicios o reinicios de aplicaciones. El mecanismo de registro usa búferes por procesador escritos en el disco por un subproceso de escritor asincrónico. Este almacenamiento en búfer permite a las aplicaciones de servidor a gran escala escribir eventos con una alteración mínima.

ETW se introdujo en Windows 2000. Desde entonces, varios componentes principales del sistema operativo y del servidor han adoptado ETW para instrumentar sus actividades. ETW es ahora una de las tecnologías clave de instrumentación en plataformas Windows. Un número creciente de aplicaciones de terceros usan ETW para la instrumentación y algunos aprovechan los eventos que proporciona Windows. ETW también se ha abstraido en la tecnología de seguimiento de software del preprocesador de Windows (WPP), que proporciona un conjunto de macros fáciles de usar para realizar el seguimiento de mensajes de estilo printf para la depuración durante el desarrollo.

ETW se actualizó significativamente para Windows Vista y Windows 7. Una de las características nuevas más importantes es el modelo y las API del proveedor de eventos unificados. En resumen, las nuevas API unificadas combinan seguimientos de registro y escritura en el Visor de eventos en un mecanismo coherente y fácil de usar para los proveedores de eventos. Al mismo tiempo, se han agregado varias características nuevas a ETW para mejorar las experiencias del desarrollador y del usuario final.

Para obtener más información sobre ETW y WPP, vea Seguimiento de eventos y Seguimiento de eventos para Windows (ETW).

Compatibilidad con USB para el registro ETW

USB es uno de los medios más frecuentes para conectar una variedad cada vez mayor de dispositivos periféricos a equipos. Hay una base muy grande instalada de equipos host USB y dispositivos periféricos USB, y proveedores de sistemas, proveedores de dispositivos y usuarios finales esperan y exigen que los dispositivos USB funcionen perfectamente en el nivel de sistema y dispositivo.

La gran base instalada y la proliferación de dispositivos USB han descubierto problemas de compatibilidad entre la pila de software USB de Windows, el controlador de host USB y los dispositivos USB. Estos problemas de compatibilidad provocan problemas para los clientes, como errores de operación del dispositivo, bloqueos del sistema y bloqueos del sistema.

Ha sido difícil o imposible investigar y depurar problemas de dispositivos USB sin acceso directo al sistema o dispositivos, o en algunos casos un volcado de memoria del sistema. Incluso con acceso total al hardware y un volcado de memoria, extraer la información pertinente ha sido una técnica que solo conoce algunos desarrolladores principales de controladores USB. Puede depurar problemas usb mediante el uso de analizadores de hardware o software, pero son muy costosos y están disponibles solo para un pequeño porcentaje de profesionales.

Compatibilidad con ETW USB en Windows 7

En Windows 7, ETW proporciona un mecanismo de registro de eventos que la pila de controladores USB puede aprovechar para ayudar a investigar, diagnosticar y depurar problemas relacionados con USB. El registro de eventos ETW de pila de controladores USB admite la mayoría o todas las funcionalidades de depuración proporcionadas por el mecanismo de registro ad hoc existente en la pila del controlador USB, sin ninguna de sus limitaciones. Esto se traduce en la facilidad de depuración de problemas relacionados con USB, lo que debe proporcionar una pila de controladores USB más sólida a largo plazo.

Hemos agregado el registro ETW a los controladores del controlador de host USB y al controlador del concentrador USB en Windows 7. La capa del controlador del controlador de host USB incluye el controlador de puerto del controlador de host (usbport.sys) y los controladores de minipuerto (usbehci.sys, usbohci.sys y usbuhci.sys). La capa del controlador del concentrador USB consta del controlador del concentrador USB (usbhub.sys). Los proveedores de eventos ETW del controlador USB se incluyen en todas las ediciones y SKU de Windows 7.

  • Eventos del concentrador USB

    Mientras la recopilación de eventos USB está habilitada, el proveedor de eventos del concentrador USB notifica la adición y eliminación de concentradores USB, los eventos de resumen del dispositivo de todos los concentradores y los cambios de estado del puerto. Puede usar estos eventos para determinar la causa principal de la mayoría de los errores de enumeración de dispositivos.

  • Eventos de puerto USB

    Mientras la recopilación de eventos USB está habilitada, el proveedor de eventos del puerto USB notifica la E/S de los controladores de cliente, la apertura y el cierre de los puntos de conexión del dispositivo y las transiciones de estado de minipuerto, como el inicio y la detención de minipuerto. La E/S registrada incluye solicitudes para el estado de los puertos USB físicos. Las transiciones de estado en puertos USB físicos son uno de los iniciadores clave de la actividad en la pila principal del controlador USB.

Compatibilidad con ETW USB en Windows 8

Windows 8 proporciona una pila de controladores USB para admitir dispositivos USB 3.0. La pila de controladores USB 3.0 proporcionada por Microsoft consta de tres controladores: Usbxhci.sys, Ucx01000.sys y Usbhub3.sys. Los tres controladores funcionan juntos para agregar compatibilidad nativa a Windows para la mayoría de los controladores host USB 3.0. La nueva pila de controladores admite dispositivos SuperSpeed, de alta velocidad, de velocidad completa y de baja velocidad. La pila de controladores USB 2.0 se admite en Windows 8. A través de seguimientos de eventos, la pila de controladores USB 3.0 proporciona una vista de la actividad específica del controlador host y de todos los dispositivos conectados a él.

  • Eventos de USB Hub3

    Mientras la recopilación de eventos USB está habilitada, el proveedor de eventos USB Hub3 informa de la adición y eliminación de concentradores USB, los eventos de resumen del dispositivo de todos los concentradores, los cambios de estado del puerto y los estados de alimentación de los dispositivos USB y los concentradores. Los cambios de estado del puerto son transiciones de estado en puertos USB físicos y son uno de los iniciadores clave de la actividad en la pila principal del controlador USB. Hub3 informa de las fases del proceso de enumeración, que apuntan a la causa principal de la mayoría de los errores de enumeración de dispositivos. Con la palabra clave StateMachine habilitada, Hub3 informa de la actividad interna de la máquina de estado para los objetos de dispositivo de software, concentrador y puerto, que proporcionan una visibilidad más profunda de la lógica del controlador.

  • Eventos UCX de USB

    Mientras la recopilación de eventos USB está habilitada, el proveedor de eventos UCX USB notifica la E/S de los controladores de cliente y la apertura y cierre de los puntos de conexión y los flujos de punto de conexión del dispositivo. Con la palabra clave StateMachine habilitada, UCX informa de la actividad interna de la máquina de estado para los objetos de punto de conexión y controlador de host, que proporcionan una visibilidad más profunda de la lógica del controlador.

  • Eventos xHCI de USB

    Mientras la recopilación de eventos USB está habilitada, el proveedor de eventos xHCI USB informa de las propiedades de los controladores xHCI del sistema y detalles de bajo nivel de la operación xHCI. xHCI notifica solicitudes de comandos enviadas y completadas por el hardware xHCI, incluidos los códigos de finalización específicos de xHCI.

En esta sección

Tema Descripción
Captura de un seguimiento de eventos USB con Logman En este tema se proporciona información sobre el uso de la herramienta Logman para capturar un seguimiento de eventos ETW USB. Logman es una herramienta de seguimiento integrada en Windows. Puede usar Logman para capturar eventos en un archivo de registro de seguimiento de eventos.
Uso de GUID de identificador de actividad en seguimientos DE ETW USB En este tema se proporciona información sobre los GUID de id. de actividad, cómo agregar esos GUID en los proveedores de seguimiento de eventos y verlos en Netmon.
Seguimientos ETW USB en Netmon Puede ver seguimientos de eventos ETW USB mediante Microsoft Network Monitor, también denominado Netmon. Netmon no analiza el seguimiento automáticamente. Requiere analizadores ETW USB. Los analizadores ETW USB son archivos de texto, escritos en lenguaje del analizador de monitor de red (NPL), que describen la estructura de seguimientos de eventos ETW USB. Los analizadores también definen columnas y filtros específicos de USB. Estos analizadores hacen de Netmon la mejor herramienta para analizar seguimientos ETW USB.
Uso de Xperf con USB ETW En este tema se describe cómo usar Xperf con Netmon para analizar datos de seguimiento USB.
Administración de energía y ETW USB En este tema se proporciona información general breve sobre el uso de ETW para examinar el estado de suspensión selectiva usb e identificar problemas de eficiencia energética del sistema mediante la utilidad Windows PowerCfg.

Uso de ETW USB
Seguimiento de eventos USB para Windows