WDTF(Windows Device Testing Framework)

WDTF(Windows Device Testing Framework) 기술에 대한 개요입니다.

WDTF(Windows Device Testing Framework)를 개발하려면 다음 헤더가 필요합니다.

• comtracing.h
• interruption.h
• itestresource.h
• logcontext.h
• logcontroller.h
• logtestresults.h
• preservelasterror.h
• resourcelist.h
• runtimeparameters.h
• screencapture.h
• te.common.h
• testdata.h
• testnotification.h
• throw.h
• tracing.h
• verify.h
• wdtf.h
• wdtfedtaction.h
• wdtfinterfaces.h
• wdtfinterfacessup.h
• wdtflogging.h
• wdtfpnpaction.h
• wdtfsimulatedbatterysystemaction.h
• wdtfsystemaction.h
• wex.common.h
• wex.logger.h
• wexassert.h
• wexdebug.h
• wexexception.h
• wexlogtrace.h
• wexstring.h
• wextestclass.h
• wextypes.h
• wppdefs.h

프로그래밍 가이드는 WDTF(Windows Device Testing Framework)를 참조하세요.

열거형

TTraceLevel TTraceLevel 열거형은 WDTF에서 추적을 위한 수준 집합을 정의합니다. 각 수준의 의미는 ITracer 인터페이스에 대한 레지스트리 설정에 따라 달라집니다.

함수

추가 컬렉션에 단일 작업을 추가합니다.
추가 컬렉션에 긴 숫자를 하나 추가합니다.
추가 컬렉션에 단일 숫자를 추가합니다.
추가 컬렉션에 단일 문자열을 추가합니다.
추가 컬렉션에 단일 항목을 추가합니다.
지우기 컬렉션에서 모든 항목을 제거합니다.
지우기 메서드가 컬렉션에서 모든 항목을 제거하는 방법을 알아봅니다.
닫기 디바이스를 닫습니다.
ConnectedStandby 시스템을 연결된 대기 상태로 전환하고 원하는 시간이 경과한 후 연결된 대기 상태를 종료합니다. 이 메서드는 Always On Always Connected(AOAC)를 지원하는 컴퓨터에서만 작동합니다.
계속 I/O를 계속합니다.
ContinueAsync I/O가 계속되도록 비동기적으로 신호를 보냅니다.
사용 안 함 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용하지 않도록 설정합니다.
사용 안 함 메서드가 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용하지 않도록 설정하는 방법을 알아봅니다.
DisableDevice 대상 디바이스를 사용하지 않도록 설정합니다.
DisableDevice 메서드가 대상 디바이스를 사용하지 않도록 설정하는 방법을 알아봅니다.
DisableObjectErrorLogging 작업에 대한 개체 오류 로깅을 사용하지 않도록 설정합니다.
DisableObjectErrorLogging 컬렉션의 모든 작업에 대해 개체 오류 로깅을 사용하지 않도록 설정합니다.
DisableObjectErrorLogging 모든 개체에 대해 개체 오류 로깅을 사용하지 않도록 설정합니다.
DisableObjectLogging 작업에 대한 개체 로깅을 사용하지 않도록 설정합니다.
DisableObjectLogging 컬렉션의 모든 작업에 대해 개체 로깅을 사용하지 않도록 설정합니다.
DisableObjectLogging 모든 개체에 대해 개체 로깅을 사용하지 않도록 설정합니다.
DisableRealBatteries 시스템에 실제 배터리가 있는 경우 실제 배터리를 사용하지 않도록 설정합니다.
DisableSimulatedBattery 시뮬레이션된 배터리를 사용하지 않도록 설정합니다.
EDTCancelRemoveDevice 대상 디바이스에 IRP_MN_CANCEL_REMOVE_DEVICE 이벤트를 보냅니다.
EDTCancelRemoveDevice 메서드가 대상 디바이스에 IRP_MN_CANCEL_REMOVE_DEVICE 이벤트를 보내는 방법을 알아봅니다.
EDTCancelStopDevice 대상 디바이스에 IRP_MN_CANCEL_STOP_DEVICE 이벤트를 보냅니다.
EDTCancelStopDevice 메서드가 대상 디바이스에 IRP_MN_CANCEL_STOP_DEVICE 이벤트를 보내는 방법을 알아봅니다.
EDTSurpriseRemoveDevice 대상 디바이스에 IRP_MN_SURPRISE_REMOVAL 이벤트를 보냅니다.
EDTSurpriseRemoveDevice 메서드가 대상 디바이스에 IRP_MN_SURPRISE_REMOVAL 이벤트를 보내는 방법을 알아봅니다.
EDTTryStopDevice 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보내려고 시도합니다.
EDTTryStopDevice 메서드가 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보내려고 시도하는 방법을 알아봅니다.
EDTTryStopDeviceFailRestart 이 메서드는 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보낸 다음 후속 디바이스를 다시 시작하지 못합니다.
EDTTryStopDeviceFailRestart EDTTryStopDeviceFailRestart 메서드가 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보낸 다음 후속 디바이스를 다시 시작하지 못하는 방법을 알아봅니다.
EDTTryStopDeviceRequestNewResources 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보내고 대상 디바이스에 새 리소스를 할당하려고 시도합니다.
EDTTryStopDeviceRequestNewResources 메서드가 대상 디바이스에 IRP_MN_STOP_DEVICE 이벤트를 보내고 대상 디바이스에 새 리소스를 할당하는 방법을 알아봅니다.
사용 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용하도록 설정합니다.
사용 메서드가 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용하도록 설정하는 방법을 알아봅니다.
EnableDevice 대상 디바이스를 사용하도록 설정합니다.
EnableDevice 메서드가 대상 디바이스를 사용하도록 설정하는 방법을 알아봅니다.
EnableObjectErrorLogging 작업에 대한 개체 오류 로깅을 사용하도록 설정합니다.
EnableObjectErrorLogging 컬렉션의 모든 작업에 대해 개체 오류 로깅을 사용하도록 설정합니다.
EnableObjectErrorLogging 모든 개체에 대해 개체 오류 로깅을 사용하도록 설정합니다.
EnableObjectLogging 작업에 대한 개체 로깅을 사용하도록 설정합니다.
EnableObjectLogging 컬렉션의 모든 작업에 대해 개체 로깅을 사용하도록 설정합니다.
EnableObjectLogging 모든 개체에 대해 개체 로깅을 사용하도록 설정합니다.
EnableRealBatteries 실제 배터리가 시스템에 있는 경우 실제 배터리를 사용하도록 설정합니다.
EnableSimulatedBattery 시뮬레이션된 배터리를 사용하도록 설정합니다.
EndTestCase 테스트 사례의 끝을 표시합니다.
Eval 이 대상이 SDEL 문과 일치하는지 여부를 평가합니다.
Eval 컬렉션의 모든 항목이 SDEL 문과 일치하는지 여부를 평가합니다.
get__NewEnum For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져옵니다.
get__NewEnum 이 IWDTFDeviceDepot2 인터페이스 메서드가 For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져오는 방법을 알아봅니다.
get__NewEnum IWDTFLongNumbers2 인터페이스의 get__NewEnum 메서드가 For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져오는 방법을 알아봅니다.
get__NewEnum get__NewEnum 메서드는 For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져옵니다.
get__NewEnum IWDTFStrings2 인터페이스의 get__NewEnum 메서드가 For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져오는 방법을 알아봅니다.
get__NewEnum 이 IWDTFTargets2 인터페이스 메서드가 For Each 루프 구조에서 암시적으로 사용하는 새 반복 변수를 가져오는 방법을 알아봅니다.
get_Config WDTF 구성 개체를 가져옵니다.
get_Context 대상의 사용자 데이터를 나타내는 이름-값 쌍을 가져오고 설정합니다.
get_Count 이 컬렉션의 작업 수를 가져옵니다.
get_Count DeviceDepot에서 현재 제공하는 디바이스 수를 가져옵니다.
get_Count 컬렉션의 긴 숫자 수를 가져옵니다.
get_Count 컬렉션의 숫자 수를 가져옵니다.
get_Count 컬렉션의 문자열 수를 가져옵니다.
get_Count 이 컬렉션의 항목 수를 가져옵니다.
get_Critical 시스템 전원 상태가 중요한지 여부를 나타내는 값을 가져오거나 설정합니다.
get_DeviceDepot DeviceDepot 개체를 가져옵니다.
get_IsRestarted RebootRestart 또는 RebootRestartWithContext 호출의 결과로 테스트 스크립트가 다시 시작되었는지 여부를 나타내는 값을 가져옵니다.
get_Item 컬렉션의 개별 작업을 가져옵니다.
get_Item DeviceDepot에서 개별 디바이스를 가져옵니다.
get_Item 컬렉션의 개별 긴 번호를 가져옵니다.
get_Item 컬렉션의 개별 번호를 가져옵니다.
get_Item 컬렉션의 개별 문자열을 가져옵니다.
get_Item 컬렉션의 개별 항목을 가져옵니다.
get_Log WDTF 로그 개체를 가져옵니다.
get_RootDevice 루트 디바이스를 가져옵니다.
get_SleepWakeTimeInSeconds 시스템이 절전 모드에서 해제되는 시간을 초 단위로 가져오거나 설정합니다.
get_SystemDepot SystemDepot 개체를 가져옵니다.
get_Target 이 작업이 참조하는 대상을 가져옵니다.
get_ThisSystem 로컬 컴퓨터를 나타내는 IWDTFTarget2 값을 가져옵니다.
get_Type 대상이 가져온 창고를 식별하는 값을 가져옵니다.
get_WDTF 이 속성이 기본 WDTF 집계 개체를 가져오는 방법을 알아봅니다.
get_WDTF 이 속성은 기본 WDTF 집계 개체를 가져옵니다.
get_WDTF 이 메서드는 기본 WDTF 집계 개체를 가져옵니다.
get_WDTF 이 메서드가 기본 WDTF 집계 개체를 가져오는 방법을 알아봅니다.
GetBits 지정된 TTraceLevel 값과 coclass의 CLSID가 지정된 경우 GetBits 메서드는 coclass에 대한 추적 플래그 집합을 비트 마스크로 반환합니다.
GetFirstSleepState 지원되는 첫 번째 절전 모드 상태를 반환합니다.
GetInterface 대상에 대한 작업을 반환합니다.
GetInterfaces 인터페이스를 지원하는 작업 컬렉션을 반환합니다( 인터페이스가 있는 각 항목에 대해 하나의 IWDTFAction2).
GetInterfacesIfExist 메서드가 인터페이스를 지원하는 작업 컬렉션(인터페이스가 있는 각 항목에 대해 하나의 IWDTFAction2)을 반환하는 방법을 알아봅니다.
GetNextSleepState 지원되는 다음 절전 모드 상태를 반환합니다.
GetRelations 관련 대상의 컬렉션을 반환합니다.
GetStatus 마지막 작업에 대한 상태 코드를 반환합니다.
GetStatusString 마지막 작업의 상태 문자열로 반환합니다.
GetValue 지정된 특성과 연결된 대상의 값을 반환합니다.
GetValueBool 지정된 특성과 연결된 대상에서 부울 값을 반환합니다.
GetValueLongNumber 지정된 특성과 연결된 대상에서 긴 숫자 값을 반환합니다.
GetValueLongNumbers 지정된 특성과 연결된 대상에서 long number 값의 컬렉션을 반환합니다.
GetValueNumber 지정된 특성과 연결된 대상의 숫자 값을 반환합니다.
GetValueNumbers 지정된 특성과 연결된 대상의 숫자 값 컬렉션을 반환합니다.
GetValueString 지정된 특성과 연결된 대상에서 문자열 값을 반환합니다.
GetValueStrings 지정된 특성과 연결된 대상의 문자열 값 컬렉션을 반환합니다.
HasContext 대상에 대해 지정된 컨텍스트가 있는지 여부를 결정합니다.
HasInterface 대상이 지정된 인터페이스를 지원하는지 여부를 결정합니다.
IsEnabled 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용할 수 있는지 여부를 나타내는 값을 가져옵니다.
IsEnabled 메서드가 대상 디바이스에서 EDT(고급 디바이스 테스트) 필터 드라이버를 사용할 수 있는지 여부를 나타내는 값을 가져오는 방법을 알아봅니다.
IsRebootRequired EDT(고급 디바이스 테스트) 필터 드라이버에 다시 부팅이 필요한지 여부를 나타내는 값을 가져옵니다.
IsRebootRequired 메서드가 EDT(고급 디바이스 테스트) 필터 드라이버에 다시 부팅이 필요한지 여부를 나타내는 값을 가져오는 방법을 알아봅니다.
IsRestartedWithContext 특정 컨텍스트에 대해 테스트 스크립트가 다시 시작되었는지 여부를 나타내는 값을 가져옵니다.
IsStatusSuccess 마지막 작업이 성공했는지 여부를 나타내는 값을 가져옵니다.
열기 디바이스를 엽니다.
OutputError 테스트 사례 로그에 오류 항목을 씁니다.
OutputInfo 테스트 사례 로그에 정보 항목을 씁니다.
일시 중지 I/O를 일시 중지합니다.
PerformIO 디바이스에 소량의 간단한 I/O를 수행합니다.
PowerAnalyzeTraceByFile 이미 수집되어 연결된 추적 메시지(.etl) 로그 파일에 저장된 전원 추적 세션을 분석합니다. 이 메서드는 Windows 8 이상에서만 작동합니다.
PowerTracingEnd 이 메서드는 전원 추적 세션을 종료합니다.
PowerTracingStart 전원 상태 전환에 대한 추적 세션을 시작하고 현재 작업 디렉터리에 추적 메시지 파일(Wdtfpwr.etl)을 저장합니다. 이 메서드는 Windows 8부터 사용할 수 있습니다.
PowerTracingStartByFile 전원 상태 전환에 대한 추적 세션을 시작하고 지정된 경로를 사용하여 추적 메시지 파일(.etl)을 저장합니다. 이 메서드는 Windows 8부터 사용할 수 있습니다.
put_Context 메서드가 대상의 사용자 데이터를 나타내는 이름-값 쌍을 가져오고 설정하는 방법을 알아봅니다.
put_Critical 시스템 전원 상태가 중요한지 여부를 나타내는 값을 설정하거나 가져옵니다.
put_SkipRestart 대상 디바이스를 기본적으로 다시 시작해야 하는지 여부를 나타내는 값을 설정합니다.
put_SkipRestart 메서드가 대상 디바이스를 기본적으로 다시 시작해야 하는지 여부를 나타내는 값을 설정하는 방법을 알아봅니다.
put_SleepWakeTimeInSeconds 시스템이 절전 모드에서 해제되는 시간을 초 단위로 설정하거나 가져옵니다.
쿼리 DeviceDepot에서 디바이스의 하위 집합을 반환합니다.
쿼리 컬렉션에 있는 항목의 하위 집합을 반환합니다.
QuerySingle DeviceDepot에서 단일 대상 디바이스를 반환합니다.
QuerySingle 컬렉션에서 단일 항목을 반환합니다.
RebootRestart 시스템 및 현재 테스트를 다시 시작합니다.
RebootRestartWithContext 시스템을 다시 부팅하고 컨텍스트 데이터를 사용하여 테스트 스크립트를 다시 시작합니다.
제거 컬렉션에서 작업을 제거합니다.
제거 컬렉션에서 긴 숫자를 제거합니다.
제거 컬렉션에서 숫자를 제거합니다.
제거 컬렉션에서 문자열을 제거합니다.
제거 컬렉션에서 항목을 제거합니다.
RemoveDevice 디바이스를 제거합니다.
RemoveDevice 메서드가 디바이스를 제거하는 방법을 알아봅니다.
RequestEjectDevice 디바이스 배출을 시작합니다.
RequestEjectDevice 메서드가 디바이스 배출을 시작하는 방법을 알아봅니다.
RescanDevice 대상 디바이스를 다시 검사합니다.
RescanDevice 메서드가 대상 디바이스를 다시 검사하는 방법을 알아봅니다.
RescanParentDevice 대상 디바이스의 부모 디바이스를 다시 검사하고 다시 열거합니다.
RescanParentDevice 메서드가 대상 디바이스의 부모 디바이스를 다시 검사하고 다시 열거하는 방법을 알아봅니다.
RestartDevice 디바이스 다시 시작을 시작합니다.
RestartDevice 메서드가 디바이스 다시 시작을 시작하는 방법을 알아봅니다.
SetSimulatedBatteryChargePercentage 시뮬레이션된 배터리로 OS에 보고된 충전 비율을 설정합니다.
SetSimulatedBatteryToAC 시뮬레이션된 배터리 상태 AC 전원으로 설정합니다.
SetSimulatedBatteryToDC 시뮬레이션된 배터리 상태 DC 전원으로 설정합니다.
SetTarget SetTarget 메서드는 WDTF에서 내부적으로 사용됩니다. 이 메서드를 직접 호출하지 마세요.
SetTraceLevel SetTraceLevel 메서드는 개체의 추적 수준을 설정합니다.
Sleep 시스템을 원하는 절전 모드 상태로 전환합니다.
시작 메서드가 디바이스를 여는 방법을 알아봅니다.
StartAsync 시작 이벤트가 발생하도록 비동기적으로 신호를 보냅니다.
StartTestCase 테스트 사례의 시작을 표시합니다.
중지 디바이스를 중지합니다.
StopAsync 중지 이벤트가 발생하도록 비동기적으로 신호를 보냅니다.
WaitAsyncCompletion 비동기 이벤트가 완료될 때까지 기다립니다.

인터페이스

IAction IAction 인터페이스는 IWDTFTarget2 인터페이스의 instance 제어할 수 있는 플러그 인입니다.
ITracer ITracer 인터페이스를 사용하면 모든 WDTF 인터페이스의 개별 인스턴스가 지정된 구현 코클래스에 대한 특정 추적 설정을 확인할 수 있습니다. 이러한 설정은 레지스트리에 기록됩니다.
ITracing ITracing 인터페이스는 개체의 TTraceLevel 값을 설정합니다. 이 인터페이스는 대부분의 WDTF 인터페이스에 대한 기본 인터페이스입니다.
IWDTF2 WDTF 컬렉션의 속성을 정의합니다.
IWDTFAction2 IWDTFTarget2 인터페이스의 instance 제어할 수 있는 작업 및 속성을 정의합니다.
IWDTFActions2 IWDTFTargets::GetInterfaces 메서드가 반환하는 작업 컬렉션에 대한 작업 및 속성을 정의합니다.
IWDTFCONFIG2 테스트 스크립트 내에서 WDTF 개체를 제어하는 작업을 정의합니다.
IWDTFDeviceDepot2 컴퓨터의 디바이스 컬렉션에 대한 속성 및 작업을 정의합니다.
IWDTFEnhancedDeviceTestSupportAction2 EDT(고급 디바이스 테스트) 필터 드라이버를 지원하는 작업 및 속성을 정의합니다.
IWDTFEnhancedDeviceTestSupportActions2 EDT(고급 디바이스 테스트) 작업의 컬렉션을 지원하는 작업 및 속성을 정의합니다.
IWDTFLOG2 테스트 사례 작성자가 WDTF 테스트 로그에 추가할 수 있도록 하는 작업을 정의합니다.
IWDTFLongNumbers2 긴 숫자 컬렉션에 대한 작업 및 속성을 정의합니다.
IWDTFNumbers2 숫자 컬렉션에 대한 작업 및 속성을 정의합니다.
IWDTFPNPAction2 PNP(플러그 앤 플레이) 디바이스 관련 테스트 인터페이스에 대한 작업 및 속성을 정의합니다.
IWDTFPNPActions2 PNP(플러그 앤 플레이) 디바이스 관련 테스트 인터페이스 컬렉션에 대한 작업 및 속성을 정의합니다.
IWDTFSimpleIOEx2 간단한 동기 I/O 기능 테스트에 대한 작업을 정의합니다.
IWDTFSimpleIOStressAction2 간단한 비동기 I/O 기능 테스트에 대한 작업을 정의합니다.
IWDTFSimpleIOStressActions2 간단한 비동기 I/O 기능 테스트 컬렉션에 대한 작업을 정의합니다.
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction 인터페이스
IWDTFStrings2 문자열 컬렉션에 대한 작업 및 속성을 정의합니다.
IWDTFSystemAction2 드라이버 테스트를 지원하는 작업 및 속성을 정의합니다.
IWDTFSystemDepot2 로컬 컴퓨터를 나타내는 개체인 SystemDepot에 대한 작업 및 속성을 정의합니다.
IWDTFTarget2 테스트 가능한 항목에 대한 작업 및 속성을 정의합니다.
IWDTFTargets2 컬렉션에 대한 속성 및 작업을 정의합니다.