Compartir a través de

La biblioteca en tiempo de ejecución de WDTF

  • Artículo

La biblioteca en tiempo de ejecución de WDTF está disponible como parte del Kit de controladores de Windows (WDK). Al instalar WDK, también se instala Windows Driver Test Framework (WDTF). Las plantillas y archivos de ejemplo para pruebas y desarrollo se instalan junto con WDK. La biblioteca en tiempo de ejecución de WDTF debe instalarse en cualquier sistema en el que quiera ejecutar pruebas basadas en WDTF. Esto incluye las pruebas proporcionadas en WDK y las pruebas que escribe mediante plantillas de prueba de WDK.

WDK también incluye un paquete de instalación independiente (*.msi) que puede usar para instalar el entorno de ejecución de WDTF en un equipo de prueba. Msi hace lo siguiente:

  • Copia archivos.

  • Agrega claves del Registro.

  • Registra objetos WDTF.

  • Instale y desinstale un archivo de registro.

La biblioteca en tiempo de ejecución de WDTF incluye herramientas para ayudarle a evaluar y ejecutar pruebas.

Nombre de la herramienta o script de comandos Descripción
CheckWDTFInstall.cmd Comprueba que WDTF se instaló correctamente. Al ejecutar este comando, se crea el archivo CheckWDTFInstall.log, que contiene información sobre todos los componentes WDTF instalados.
DisplayDeviceClass.vbs Muestra información de clase de dispositivo que existe en el sistema actual. Se muestran tanto el GUID de clase como el nombre descriptivo de clase. Resulta útil al intentar crear consultas /DQ que buscan determinadas clases de dispositivos.
DisplayDeviceDataFields.cmd Muestra información de clase de dispositivo que existe en el sistema actual. Se muestran tanto el GUID de clase como el nombre descriptivo de clase. Resulta útil al intentar crear consultas /DQ que buscan determinadas clases de dispositivos.
DisplayDevices.vbs Muestra información sobre cada dispositivo expresado por el parámetro /DQ; el valor predeterminado es todo el dispositivo del sistema.
DisplayDevicesWithWDTFilters.vbs Muestra cualquier dispositivo que tenga uno de los controladores de filtro WDTF instalados en él. WDTF tiene tres controladores de filtro: EDT, IOSPY o el controlador de botón.
DisplayDeviceTree.vbs Muestra el árbol de dispositivos del sistema actual.
DisplaySystemDataFields.cmd Muestra todos los espacios de nombres del sistema y los campos que tienen.

Instalación de la biblioteca en tiempo de ejecución de WDTF

Al configurar un equipo de prueba para la implementación, la biblioteca en tiempo de ejecución de WDTF se instala en el equipo de prueba. Siga las instrucciones de Aprovisionamiento de un equipo para la implementación y pruebas de controladores (WDK 10 y WDK 8.1)

También puede instalar manualmente la biblioteca en tiempo de ejecución de WDTF.

Instalación de WDTF en un equipo de prueba (método preferido)

  1. Instale Visual Studio e instale WDK.

  2. Configure un equipo remoto para realizar pruebas. En Visual Studio, seleccione el menú Controlador , seleccione Probar y, a continuación, seleccione Configurar equipos.

Instalación manual de WDTF en un equipo de prueba (método alternativo)

  1. Instale Visual Studio y WDK en el equipo que use para el desarrollo.

  2. Copie los archivos de instalación WDTF desde el equipo donde instaló el WDK en el equipo de prueba. Los archivos de instalación WDTF (*.msi y *archivos .cab) se encuentran en el directorio %programfiles%\Windows Kits\10\Testing\Runtimes del sistema de desarrollo. Copie todos los archivos del directorio que coincidan con la arquitectura del equipo de prueba.

  3. En el equipo de prueba, abra una ventana del símbolo del sistema con permisos elevados (Ejecutar como administrador) y vaya al directorio que contiene los archivos de instalación WDTF. Ejecute cualquiera de los siguientes comandos para instalar WDTF.

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"

-O bien-

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"

En la tabla siguiente se describen las opciones que puede usar con el comando msiexec .

Opción Descripción
/L* Nombre Escribe todos los mensajes y errores en un archivo, nombre de archivo.
WDTFDIR=CustomInstallationDirectory Especifica un directorio de destino para los entornos de ejecución de WDTF. WDTFDir predeterminado es %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] Especifique 1 para omitir la configuración cscript.exe como motor de script predeterminado. Especifique 2 para omitir la habilitación de la reactivación de AC y DC RTC.
/? Muestra ayuda para msiexec.exe opciones.

Ejemplo

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

Cómo determinar si la biblioteca en tiempo de ejecución de WDTF está instalada en un equipo

Para comprobar que WDTF se instaló correctamente, ejecute un script de comando en el equipo de prueba. Al ejecutar este comando, se crea el archivo CheckWDTFInstall.log, que contiene información sobre todos los componentes WDTF instalados.

  1. Abra una ventana del símbolo del sistema en el equipo de prueba.

  2. Ejecute %WDTFDir%\Tools\CheckWDTFInstall.cmd.

  3. Abra el archivo de registro CheckWDTFInstall.log y examine los resultados.

Cómo desinstalar la biblioteca en tiempo de ejecución de WDTF

Al configurar un equipo de prueba para la implementación, siguiendo las instrucciones Aprovisionamiento de un equipo para la implementación y pruebas de controladores (WDK 10), la biblioteca en tiempo de ejecución de WDTF se instala en el equipo de destino.

Puede quitar la biblioteca en tiempo de ejecución de WDTF quitando el aprovisionamiento del equipo de destino. Para obtener más información, consulte Eliminación del aprovisionamiento del equipo de destino.

También puede desinstalar manualmente la biblioteca en tiempo de ejecución de WDTF.

Desinstalación manual de WDTF en un equipo de prueba

  1. En el equipo de prueba, vaya a Configuración y seleccione Aplicaciones.

  2. En Programas y características, busque las bibliotecas en tiempo de ejecución de Windows Driver Testing Framework (WDTF), seleccione y mantenga presionado (o haga clic con el botón derecho) y seleccione Desinstalar.