WDTF 런타임 라이브러리

아티클
06/15/2023

WDTF 런타임 라이브러리는 WDK(Windows 드라이버 키트)의 일부로 사용할 수 있습니다. WDK를 설치할 때 WDTF(Windows 드라이버 테스트 프레임워크)도 설치합니다. 테스트 및 개발을 위한 템플릿 및 샘플 파일은 WDK와 함께 설치됩니다. WDTF 기반 테스트를 실행하려는 모든 시스템에 WDTF 런타임 라이브러리를 설치해야 합니다. 여기에는 WDK에 제공된 테스트와 WDK 테스트 템플릿을 사용하여 작성하는 테스트가 포함됩니다.

WDK에는 테스트 컴퓨터에 WDTF 런타임을 설치하는 데 사용할 수 있는 별도의 설치 패키지(*.msi)도 포함되어 있습니다. MSI는 다음을 수행합니다.

파일을 복사합니다.
레지스트리 키를 추가합니다.
WDTF 개체를 등록합니다.
로그 파일을 설치하고 제거합니다.

WDTF 런타임 라이브러리에는 테스트를 심사하고 실행하는 데 도움이 되는 도구가 포함되어 있습니다.

도구 또는 명령 스크립트의 이름	설명
CheckWDTFInstall.cmd	WDTF가 올바르게 설치되었는지 확인합니다. 이 명령을 실행하면 설치된 모든 WDTF 구성 요소에 대한 정보가 포함된 CheckWDTFInstall.log 파일이 만들어집니다.
DisplayDeviceClass.vbs	현재 시스템에 있는 디바이스 클래스 정보를 표시합니다. 클래스 GUID와 클래스 식별 이름이 모두 표시됩니다. 특정 디바이스 클래스를 찾는 /DQ 쿼리를 만들 때 유용합니다.
DisplayDeviceDataFields.cmd	현재 시스템에 있는 디바이스 클래스 정보를 표시합니다. 클래스 GUID와 클래스 식별 이름이 모두 표시됩니다. 특정 디바이스 클래스를 찾는 /DQ 쿼리를 만들 때 유용합니다.
DisplayDevices.vbs	/DQ 매개 변수로 표현된 각 디바이스에 대한 정보를 표시합니다. 기본값은 시스템의 모든 디바이스입니다.
DisplayDevicesWithWDTFilters.vbs	WDTF 필터 드라이버 중 하나가 설치된 모든 디바이스를 표시합니다. WDTF에는 EDT, IOSPY 또는 단추 드라이버의 세 가지 필터 드라이버가 있습니다.
DisplayDeviceTree.vbs	현재 시스템의 디바이스 트리를 표시합니다.
DisplaySystemDataFields.cmd	모든 시스템 네임스페이스와 해당 네임스페이스가 있는 필드를 표시합니다.

WDTF 런타임 라이브러리를 설치하는 방법

배포를 위해 테스트 컴퓨터를 설정하면 WDTF 런타임 라이브러리가 테스트 컴퓨터에 설치됩니다. 드라이버 배포 및 테스트를 위한 컴퓨터 프로비전(WDK 10 및 WDK 8.1)의 지침을 따릅니다.

WDTF 런타임 라이브러리를 수동으로 설치할 수도 있습니다.

테스트 컴퓨터에 WDTF 설치(기본 방법)

Visual Studio를 설치한 다음 WDK를 설치합니다.
테스트를 위해 원격 컴퓨터를 구성합니다. Visual Studio에서 드라이버 메뉴를 선택하고 테스트를 가리킨 다음 컴퓨터 구성을 선택합니다.

테스트 컴퓨터에 WDTF 수동 설치(대체 방법)

개발에 사용하는 컴퓨터에 Visual Studio 및 WDK를 설치합니다.
WDK를 설치한 컴퓨터에서 테스트 컴퓨터로 WDTF 설치 파일을 복사합니다. WDTF 설치 파일(*.msi 및 *.cab 파일)은 개발 시스템의 %programfiles%\Windows Kits\10\Testing\Runtimes 디렉터리에 있습니다. 테스트 컴퓨터의 아키텍처와 일치하는 디렉터리의 모든 파일을 복사합니다.
테스트 컴퓨터에서 관리자 권한(관리자 권한으로 실행)을 사용하여 명령 프롬프트 창을 열고 WDTF 설치 파일이 포함된 디렉터리로 이동합니다. 다음 명령 중 하나를 실행하여 WDTF를 설치합니다.

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

-또는-

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

다음 표에서는 msiexec 명령과 함께 사용할 수 있는 옵션에 대해 설명합니다.

옵션	설명
/L* 파일	파일 이름에 모든 메시지와 오류를 씁니다.
WDTFDIR=CustomInstallationDirectory	WDTF 런타임의 대상 디렉터리를 지정합니다. 기본 WDTFDir 은 %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF입니다.
WDTF_SKIP_MACHINE_CONFIG=[1 \| 2]	기본 스크립트 엔진으로 cscript.exe 설정을 건너뛰려면 1 을 지정합니다. AC 및 DC RTC 절전 모드 해제 사용을 건너뛰려면 2 를 지정합니다.
/?	msiexec.exe 옵션에 대한 도움말을 표시합니다.

예제

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

컴퓨터에 WDTF 런타임 라이브러리가 설치되어 있는지 확인하는 방법

테스트 컴퓨터에서 명령 스크립트를 실행하여 WDTF가 올바르게 설치되었는지 확인할 수 있습니다. 이 명령을 실행하면 설치된 모든 WDTF 구성 요소에 대한 정보가 포함된 CheckWDTFInstall.log 파일이 만들어집니다.

테스트 컴퓨터에서 명령 프롬프트 창을 엽니다.
%WDTFDir%\Tools\CheckWDTFInstall.cmd을 실행합니다.
로그 파일 CheckWDTFInstall.log를 열고 결과를 검사합니다.

WDTF 런타임 라이브러리를 제거하는 방법

배포를 위해 테스트 컴퓨터를 설정할 때 드라이버 배포 및 테스트용 컴퓨터 프로비전(WDK 10)에 따라 WDTF 런타임 라이브러리가 대상 컴퓨터에 설치됩니다.

대상 컴퓨터에서 프로비저닝을 제거하여 WDTF 런타임 라이브러리를 제거할 수 있습니다. 자세한 내용은 대상 컴퓨터에서 프로비저닝 제거를 참조하세요.

WDTF 런타임 라이브러리를 수동으로 제거할 수도 있습니다.

테스트 컴퓨터에서 WDTF 수동 제거

테스트 컴퓨터에서 설정 으로 이동한 다음, 앱을 선택합니다.
프로그램 및 기능에서 WDTF(Windows 드라이버 테스트 프레임워크) 런타임 라이브러리를 찾아서 길게 누르거나 마우스 오른쪽 단추로 클릭하고 제거를 선택합니다.

다음을 통해 공유