WDTF (Windows Device Testing Framework)

Visão geral da tecnologia WDTF (Windows Device Testing Framework).

Para desenvolver o WDTF (Windows Device Testing Framework), você precisa desses cabeçalhos:

• 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

Para obter o guia de programação, consulte Estrutura de Teste de Dispositivo do Windows (WDTF).

Enumerações

TTraceLevel A enumeração TTraceLevel define um conjunto de níveis para rastreamento no WDTF. O significado em cada nível depende das configurações do Registro para a interface do ITracer.

Funções

Adicionar Adicione uma única ação à coleção.
Adicionar Adiciona um único número longo à coleção.
Adicionar Adiciona um único número à coleção.
Adicionar Adiciona uma única cadeia de caracteres à coleção.
Adicionar Adicione um único item à coleção.
Limpar Remove todos os itens da coleção.
Limpar Saiba como o método remove todos os itens da coleção.
Fechar Fecha o dispositivo.
ConnectedStandby Coloca o sistema no estado de Espera Conectada e sai do estado de Espera Conectado após o tempo desejado ter passado. Esse método só funciona em um computador que dá suporte a Always On AoAC (Always Connected).
Continuar Continua a E/S.
ContinueAsync Sinaliza de forma assíncrona a E/S para continuar.
Desabilitar Desabilita o driver de filtro EDT (Teste avançado de dispositivo) no dispositivo de destino.
Desabilitar Saiba como o método desabilita o driver de filtro EDT (Teste avançado de dispositivo) no dispositivo de destino.
DisableDevice Desabilita o dispositivo de destino.
DisableDevice Saiba como o método desabilita o dispositivo de destino.
DisableObjectErrorLogging Desabilita o log de erros de objeto para a ação.
DisableObjectErrorLogging Desabilite o log de erros de objeto para todas as ações na coleção.
DisableObjectErrorLogging Desabilita o log de erros de objeto para todos os objetos.
DisableObjectLogging Desabilita o log de objetos para a ação.
DisableObjectLogging Desabilite o log de objetos para todas as ações na coleção.
DisableObjectLogging Desabilita o log de objetos para todos os objetos.
DisableRealBatteries Desabilita baterias reais se elas estiverem presentes no sistema.
DisableSimulatedBattery Desabilita a bateria simulada.
EDTCancelRemoveDevice Envia um evento IRP_MN_CANCEL_REMOVE_DEVICE para o dispositivo de destino.
EDTCancelRemoveDevice Saiba como o método envia um evento IRP_MN_CANCEL_REMOVE_DEVICE para o dispositivo de destino.
EDTCancelStopDevice Envia um evento IRP_MN_CANCEL_STOP_DEVICE para o dispositivo de destino.
EDTCancelStopDevice Saiba como o método envia um evento IRP_MN_CANCEL_STOP_DEVICE para o dispositivo de destino.
EDTSurpriseRemoveDevice Envia um evento IRP_MN_SURPRISE_REMOVAL para o dispositivo de destino.
EDTSurpriseRemoveDevice Saiba como o método envia um evento IRP_MN_SURPRISE_REMOVAL para o dispositivo de destino.
EDTTryStopDevice Tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino.
EDTTryStopDevice Saiba como o método tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino.
EDTTryStopDeviceFailRestart Esse método tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e, em seguida, falha na reinicialização do dispositivo subsequente.
EDTTryStopDeviceFailRestart Saiba como o método EDTTryStopDeviceFailRestart tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e, em seguida, falha na reinicialização do dispositivo subsequente.
EDTTryStopDeviceRequestNewResources Tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e atribuir novos recursos ao dispositivo de destino.
EDTTryStopDeviceRequestNewResources Saiba como o método tenta enviar um evento IRP_MN_STOP_DEVICE para o dispositivo de destino e atribuir novos recursos ao dispositivo de destino.
Habilitar Habilita o driver de filtro EDT (Teste avançado de dispositivo) no dispositivo de destino.
Habilitar Saiba como o método habilita o driver de filtro EDT (Teste de Dispositivo Avançado) no dispositivo de destino.
EnableDevice Habilita o dispositivo de destino.
EnableDevice Saiba como o método habilita o dispositivo de destino.
EnableObjectErrorLogging Habilita o log de erros de objeto para a ação.
EnableObjectErrorLogging Habilite o log de erros de objeto para todas as ações na coleção.
EnableObjectErrorLogging Habilita o log de erros de objeto para todos os objetos.
EnableObjectLogging Habilita o log de objetos para a ação.
EnableObjectLogging Habilite o log de objetos para todas as ações na coleção.
EnableObjectLogging Habilita o log de objetos para todos os objetos.
EnableRealBatteries Habilita baterias reais se elas estiverem presentes no sistema.
EnableSimulatedBattery Habilita a bateria simulada.
EndTestCase Marca o fim de um caso de teste.
Eval Avalie se esse destino corresponde a uma instrução SDEL.
Eval Avalia se todos os itens na coleção correspondem a uma instrução SDEL.
get__NewEnum Obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get__NewEnum Saiba como esse método de interface IWDTFDeviceDepot2 obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get__NewEnum Saiba como o método get__NewEnum da interface IWDTFLongNumbers2 obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get__NewEnum O método get__NewEnum obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get__NewEnum Saiba como o método get__NewEnum da interface IWDTFStrings2 obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get__NewEnum Saiba como esse método de interface IWDTFTargets2 obtém uma nova variável de iteração que a estrutura de loop For Each usa implicitamente.
get_Config Obtém o objeto de configuração WDTF.
get_Context Obtém e define um par nome-valor que representa os dados do usuário para o destino.
get_Count Obtém o número de ações nesta coleção.
get_Count Obtém o número de dispositivos fornecidos atualmente pelo DeviceDepot.
get_Count Obtém o número de números longos na coleção.
get_Count Obtém o número de números na coleção.
get_Count Obtém o número de cadeias de caracteres na coleção.
get_Count Obtém o número de itens nesta coleção.
get_Critical Obtém ou define um valor que indica se o estado de energia do sistema é crítico.
get_DeviceDepot Obtém o objeto DeviceDepot.
get_IsRestarted Obtém um valor que indica se o script de teste foi reiniciado como resultado de uma chamada para RebootRestart ou RebootRestartWithContext.
Get_item Obtém uma ação individual na coleção.
Get_item Obtém um dispositivo individual no DeviceDepot.
Get_item Obtém um número longo individual na coleção.
Get_item Obtém um número individual na coleção.
Get_item Obtém uma cadeia de caracteres individual na coleção.
Get_item Obtém um item individual na coleção.
get_Log Obtém o objeto de log WDTF.
get_RootDevice Obtém o dispositivo raiz.
get_SleepWakeTimeInSeconds Obtém ou define o tempo em segundos em que o sistema será ativado do estado de suspensão.
get_SystemDepot Obtém o objeto SystemDepot.
get_Target Obtém o destino ao qual essa ação se refere.
get_ThisSystem Obtém um valor IWDTFTarget2 que representa o computador local.
get_Type Obtém um valor que identifica o depósito do qual o destino vem.
get_WDTF Saiba como essa propriedade obtém o main objeto de agregação WDTF.
get_WDTF Essa propriedade obtém a main objeto de agregação WDTF.
get_WDTF Esse método obtém o main objeto de agregação WDTF.
get_WDTF Saiba como esse método obtém o main objeto de agregação WDTF.
Getbits O método GetBits retorna o conjunto de sinalizadores de rastreamento para uma coclasse como uma máscara de bits, dado um valor TTraceLevel especificado e o CLSID da coclass.
GetFirstSleepState Retorna o primeiro estado de suspensão com suporte.
Getinterface Retorna uma ação para o destino.
Getinterfaces Retorna uma coleção de ações que dão suporte à interface – uma IWDTFAction2 para cada item que tem um.
GetInterfacesIfExist Saiba como o método retorna uma coleção de ações que dão suporte à interface – uma IWDTFAction2 para cada item que tem um.
GetNextSleepState Retorna o próximo estado de suspensão com suporte.
GetRelations Retorna uma coleção de destinos relacionados.
GetStatus Retorna o código status da última operação.
GetStatusString Retorna o status da última operação como uma cadeia de caracteres.
GetValue Retorna um valor do destino associado a um atributo especificado.
GetValueBool Retorna um valor booliano do destino associado a um atributo especificado.
GetValueLongNumber Retorna um valor numérico longo do destino associado a um atributo especificado.
GetValueLongNumbers Retorna uma coleção de valores numéricos longos do destino associados a um atributo especificado.
GetValueNumber Retorna um valor numérico do destino associado a um atributo especificado.
GetValueNumbers Retorna uma coleção de valores numéricos do destino associados a um atributo especificado.
GetValueString Retorna um valor de cadeia de caracteres do destino associado a um atributo especificado.
GetValueStrings Retorna uma coleção de valores de cadeia de caracteres do destino associados a um atributo especificado.
HasContext Determina se existe um determinado contexto para o destino.
HasInterface Determina se o destino dá suporte a uma determinada interface.
IsEnabled Obtém um valor que indica se o driver de filtro EDT (Teste de Dispositivo Avançado) está habilitado no dispositivo de destino.
IsEnabled Saiba como o método obtém um valor que indica se o driver de filtro EDT (Teste de Dispositivo Avançado) está habilitado no dispositivo de destino.
IsRebootRequired Obtém um valor que indica se o driver de filtro EDT (Teste de Dispositivo Avançado) requer uma reinicialização.
IsRebootRequired Saiba como o método obtém um valor que indica se o driver de filtro edt (Teste de Dispositivo Avançado) requer uma reinicialização.
IsRestartedWithContext Obtém um valor que indica se o script de teste foi reiniciado para um contexto específico.
IsStatusSuccess Obtém um valor que indica se a última operação foi bem-sucedida.
Abrir Abre o dispositivo.
OutputError Grava uma entrada de erro no log de casos de teste.
OutputInfo Grava uma entrada informativa no log de casos de teste.
Pausar Pausa a E/S.
PerformIO Executa uma pequena quantidade de E/S simples para o dispositivo.
PowerAnalyzeTraceByFile Analisa uma sessão de rastreamento de energia que já foi coletada e armazenada no arquivo de log da mensagem de rastreamento associada (.etl). Esse método só funcionará no Windows 8 e superior.
PowerTracingEnd Esse método encerra uma sessão de rastreamento de energia.
PowerTracingStart Inicia uma sessão de rastreamento para transições de estado de energia e salva o arquivo de mensagem de rastreamento (Wdtfpwr.etl) no diretório de trabalho atual. Esse método está disponível a partir do Windows 8.
PowerTracingStartByFile Inicia uma sessão de rastreamento para transições de estado de energia e salva o arquivo de mensagem de rastreamento (.etl) usando o caminho especificado. Esse método está disponível a partir do Windows 8.
put_Context Saiba como o método obtém e define um par nome-valor que representa os dados do usuário para o destino.
put_Critical Define ou obtém um valor que indica se o estado de energia do sistema é crítico.
put_SkipRestart Define um valor que indica se o dispositivo de destino deve ser reiniciado por padrão.
put_SkipRestart Saiba como o método define um valor que indica se o dispositivo de destino deve ser reiniciado por padrão.
put_SleepWakeTimeInSeconds Define ou obtém o tempo em segundos em que o sistema será ativado do estado de suspensão.
Consulta Retorna um subconjunto dos dispositivos no DeviceDepot.
Consulta Retorna um subconjunto dos itens na coleção.
QuerySingle Retorna um único dispositivo de destino do DeviceDepot.
QuerySingle Retorna um único item da coleção.
RebootRestart Reinicie o sistema e o teste atual.
RebootRestartWithContext Reinicializa o sistema e reinicia o script de teste com dados de contexto.
Remover Remova uma ação da coleção.
Remover Remove um número longo da coleção.
Remover Remove um número da coleção.
Remover Remove uma cadeia de caracteres da coleção.
Remover Remove um item da coleção.
RemoveDevice Remove o dispositivo.
RemoveDevice Saiba como o método remove o dispositivo.
RequestEjectDevice Inicia uma ejeção de dispositivo.
RequestEjectDevice Saiba como o método inicia uma ejeção de dispositivo.
RescanDevice Verifica novamente o dispositivo de destino.
RescanDevice Saiba como o método verifica novamente o dispositivo de destino.
RescanParentDevice Verifica novamente e renumera o dispositivo pai do dispositivo de destino.
RescanParentDevice Saiba como o método verifica novamente e renumera o dispositivo pai do dispositivo de destino.
RestartDevice Inicia uma reinicialização do dispositivo.
RestartDevice Saiba como o método inicia uma reinicialização do dispositivo.
SetSimulatedBatteryChargePercentage Define o percentual de carga relatado ao sistema operacional pela bateria simulada.
SetSimulatedBatteryToAC Define a bateria simulada status como energia CA.
SetSimulatedBatteryToDC Define a bateria simulada status como energia dc.
SetTarget O método SetTarget é usado internamente pelo WDTF. Não chame este método diretamente.
SetTraceLevel O método SetTraceLevel define o nível de rastreamento de um objeto .
Modo de suspensão Coloca o sistema no estado de suspensão desejado.
Iniciar Saiba como o método abre o dispositivo.
StartAsync Sinaliza de forma assíncrona um evento de início para ocorrer.
StartTestCase Marca o início de um caso de teste.
Parar Interrompe o dispositivo.
StopAsync Sinaliza de forma assíncrona o evento de parada a ocorrer.
WaitAsyncCompletion Aguarda a conclusão de qualquer um dos eventos assíncronos.

Interfaces

Iaction As interfaces IAction são plug-ins que podem controlar uma instância da interface IWDTFTarget2.
ITracer A interface ITracer permite que instâncias individuais de cada interface WDTF determinem as configurações de rastreamento específicas para uma determinada coclass de implementação. Essas configurações são registradas no registro.
ITracing A interface ITracing define o valor de TTraceLevel de um objeto. Essa interface é uma interface base para a maioria das interfaces WDTF.
IWDTF2 Define propriedades para a coleção WDTF.
IWDTFAction2 Define operações e propriedades que podem controlar uma instância da interface IWDTFTarget2.
IWDTFActions2 Define operações e propriedades para a coleção de ações retornadas pelo método IWDTFTargets::GetInterfaces.
IWDTFCONFIG2 Define operações que controlam objetos WDTF em um script de teste.
IWDTFDeviceDepot2 Define propriedades e operações para a coleção de dispositivos em um computador.
IWDTFEnhancedDeviceTestSupportAction2 Define operações e propriedades que dão suporte ao driver de filtro EDT (Teste de Dispositivo Avançado).
IWDTFEnhancedDeviceTestSupportActions2 Define operações e propriedades que dão suporte à coleção de ações de EDT (Teste de Dispositivo Avançado).
IWDTFLOG2 Define operações que permitem que o autor do caso de teste adicione ao log de teste do WDTF.
IWDTFLongNumbers2 Define operações e propriedades para uma coleção de números longos.
IWDTFNumbers2 Define operações e propriedades para uma coleção de números.
IWDTFPNPAction2 Define operações e propriedades para as interfaces de teste relacionadas ao dispositivo PNP (Plug and Play).
IWDTFPNPActions2 Define operações e propriedades para a coleção de interfaces de teste relacionadas ao dispositivo PNP (Plug and Play).
IWDTFSimpleIOEx2 Define operações para um teste de funcionalidade de E/S síncrono simples.
IWDTFSimpleIOStressAction2 Define operações para um simples teste de funcionalidade de E/S assíncrona.
IWDTFSimpleIOStressActions2 Define operações para uma coleção de testes simples de funcionalidade de E/S assíncrona.
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction Interface
IWDTFStrings2 Define operações e propriedades para uma coleção de cadeias de caracteres.
IWDTFSystemAction2 Define operações e propriedades que dão suporte ao teste de driver.
IWDTFSystemDepot2 Define operações e propriedades para o SystemDepot – o objeto que representa o computador local.
IWDTFTarget2 Define operações e propriedades para um item testável.
IWDTFTargets2 Define propriedades e operações para a coleção.