DriverPackage

Article
01/12/2012

The DriverPackage interface provides information about a driver package that has not been published to the Microsoft Windows Device Testing Framework (WDTF) driver package collection.

A driver package contains the INF file and driver, together with other associated files, for a device.

interface IDriverPackage : IAction

Properties

Date
The date of the unpublished driver package.
Inf
The name of the INF file that defines the unpublished driver package
Version
The version of the unpublished driver package, which might be different than the version of individual drivers within the driver package.

The following properties are reserved for future use. Do not use them.

ClassGuid
The GUID of the class of the drivers in this package.
ClassName
The name of the class of the drivers in this package.
Provider
The name of the company that provides the drivers in this package.
CatalogFile
The catalog file of this driver package.
DigitalSigner
The identity of the signer of the driver package.
DigitalSignerVersion
The version of the signer of the driver package.

Remarks

The DriverPackage action interface acts on an instance of the ITarget interface retrieved from the DeviceDepot property. You can retrieve a target-specific implementation of an action interface by calling the ITarget::GetInterface method with the desired WDTFProgID. You can retrieve the published DriverPackage that was used to install a driver on a particular target in this manner.

You can use the properties of the DriverPackage interface to create different test scenarios that require you to manage the drivers at the device level. However, in order to use WDTF to stage and install driver packages, you must first publish the package to the WDTF driver package collection. Driver packages are published to the WDTF driver package collection by using one of the following methods:

The driver package is for an in-box driver that is included in the default installation of Windows.
The driver package is published by using either the DeviceManagement::AddDriverPackage or DeviceManagement::InstallDriver methods.

The DeviceManagement for System Targets interface and DeviceManagement for Device Targets interface also provide methods and properties that might be helpful when you use them with the DriverPackage interface.

Implementation Details

WDTFProgID: DriverPackage

TraceLevel Path: HKCR\WDTFActions.1\Device\DriverPackage\

Note The implementation of this interface is not thread-safe.

Type Libraries

WDTF.tlb

WDTFInterfaces.tlb

DeviceManagement.tlb

Action Interfaces

Device Action Interfaces

DeviceDepot

DeviceManagement for Device Targets