Compartilhar via

Criando cenários do WDTF

  • Artigo

Você pode começar seus cenários baseados em WDTF criando uma instância da interface de agregação IWDTF2 , que contém as propriedades DeviceDepot e SystemDepot .

Para coletar um ou mais objetos de destino, use a interface IWDTFDeviceDepot2 e use o método Query com o SDEL ( Simple Data Evaluation Language ).

Um script também pode examinar destinos específicos usando o método IWDTFTarget2::Eval . Depois de escolher os destinos, controle-os usando uma ou mais interfaces de ação.

Antes de começar a desenvolver cenários do WDTF, você deve instalar o WDTF. Consulte Início Rápido do WDTF para obter mais informações.

As seções a seguir neste tópico descrevem como criar cenários básicos do WDTF.

Cenário simples do WDTF

O exemplo de código VBScript a seguir (WDTF_Sample1.vbs) mostra um cenário simplificado que usa o WDTF para habilitar e desabilitar todos os dispositivos não fantasmas. Um dispositivo não fantasma é qualquer dispositivo fisicamente presente. Para obter exemplos completos, consulte Cenários WDTF de exemplo.

Set WDTF = WScript.CreateObject("WDTF.WDTF")
For Each Device In WDTF.DeviceDepot.Query("IsPhantom=false AND IsDisableable")
    On Error Resume Next
    Set DevMan = Device.GetInterface("DeviceManagement")
    If err <> 0 Then
 DevMan.Disable()
 DevMan.Enable()
    End If
Next

Você pode executar esse cenário executando CScript.exe WDTF_Sample1.vbs.

Armazenando informações de destino usando o contexto

Algumas linguagens de programação, como VBScript, não gerenciam facilmente referências de objeto. Para simplificar esse gerenciamento no WDTF, cada destino fornece uma propriedade Context que você pode usar para armazenar pares de chave/valor arbitrários, incluindo referências a objetos ativos. Essa propriedade é especialmente útil para armazenar interfaces de ação para que você possa usá-las mais tarde. O exemplo de código VBScript a seguir armazena uma ação IWDTFSimpleIOStressAction2 em um item de contexto nomeado.

deviceObj.Context("IWDTFSimpleIOStressAction2") = SimpleIOObj

Posteriormente, seu cenário pode parar, pausar ou reiniciar a interface IWDTFSimpleIOStressAction2 acessando-a por meio do Contexto novamente, como mostra o exemplo de código a seguir.

Device.Context("IWDTFSimpleIOStressAction2").Stop

Detectando dispositivos fantasmas

Dispositivos fantasmas são dispositivos que foram fisicamente instalados no computador no passado, mas não estão presentes no momento. Por exemplo, um dispositivo fantasma pode ser um mouse USB que foi desconectado. Para acelerar e simplificar a reinstalação de um dispositivo conectado a um computador que está ligado ou removido de dispositivos, o sistema operacional Windows mantém os drivers de dispositivo instalados, mas marca o dispositivo como um fantasma.

Os destinos do tipo de dispositivo incluem um atributo IsPhantom (e o atributo IsAttached , que é equivalente a IsPhantom=false) que especifica a presença física do hardware. O exemplo de código VBScript a seguir lista uma coleção de todos os dispositivos que estão fisicamente presentes no computador.

Set NonPhantomDevices = WDTF.DeviceDepot.Query ("IsAttached")

Para obter mais palavras-chave de atributo, consulte Tokens SDEL.