WPD Compliance Tests - Events (Manual)

Article
03/17/2021

This test exercises the driver by using the Windows Portable Device (WPD) API and validates that the driver complies with the Windows Hardware Certification requirements.

This test verifies that a driver or device fulfills the Windows Hardware Certification requirements to work seamlessly with the WPD stack in a protocol-independent way.

Test details


Specifications	Device.Portable.Core.TransportBluetooth Device.Portable.Core.TransportIP Device.Portable.Core.TransportUSB Device.Portable.Core.MediaSync Device.Portable.Core.VideoCodec Device.Portable.Core.AudioCodec
Platforms	Windows 10, client editions (x86) Windows 10, client editions (x64)
Supported Releases	Windows 10 Windows 10, version 1511 Windows 10, version 1607 Windows 10, version 1703 Windows 10, version 1709 Windows 10, version 1803 Windows 10, version 1809 Windows 10, version 1903 Next update to Windows 10
Expected run time (in minutes)	2
Category	Development
Timeout (in minutes)	120
Requires reboot	false
Requires special configuration	false
Type	automatic

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Device.Portable additional documentation

Running the test

Before you run the test, complete the test setup as described in the test requirements: Device.Portable Testing Prerequisites.

Note

You may need additional hardware if the test device provides bus-specific support. To determine whether you need additional hardware, see the description for each bus-specific test.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Portable Testing.

This returns Pass or Fail. The test might return SKIP if the device does not support specific device services. To review test details, review the test log from HLK Studio.

Additional troubleshooting information:

The test supports verbose logging when in manual test case selection mode. When the application is running, go to Options, Logging Options, and click Destination: Window, Level: 10.
If no test cases are available from the tree for test-case selection, make sure that the device is plugged in.

More information

This test runs as a C++ application. When run outside of HLK Studio, there is a test case selection user interface and test suites can be defined using test profiles as is the case for the WLK. It provides a Pass/Fail for each requirement. The test validates the following scenarios and function categories for a WPD driver and the device that's connected to it.

The device or driver passes these common scenarios for content types and formats that it supports:

Object hierarchy enumeration
Object property retrieval
Object resource reads from device
Object resource writes to device
Object deletion
Power management
Device-generated or driver-generated events

The device or driver supports the following known function categories:

Required object properties and attributes
Resources and attributes

Function category requirements

Recommended:

WPD_FUNCTIONAL_CATEGORY_STORAGE
WPD_FUNCTIONAL_CATEGORY_DEVICE
WPD_FUNCTIONAL_CATEGORY_SMS

Optional:

WPD_FUNCTIONAL_CATEGORY_STILL_IMAGE_CAPTURE
WPD_FUNCTIONAL_CATEGORY_AUDIO_CAPTURE

Content type and format requirements

If a content type isn't supported, the format support won't be verified. There are no strict requirements on the format or content type, because this is typically an implementation detail for device firmware. The driver can report support for any format or content type, as long as it passes the functional scenario tests that use objects of formats that it supports, like transfer, deletion, and enumeration. These formats and content types can serve as a guideline:

Recommended content type: WPD_CONTENT_TYPE_AUDIO
Recommended formats:
- WPD_OBJECT_FORMAT_WMA
- WPD_OBJECT_FORMAT_MP3
Optional content type: WPD_CONTENT_TYPE_VIDEO
Recommended format: WPD_OBJECT_FORMAT_WMV
Optional content type: WPD_CONTENT_TYPE_IMAGE
Recommended formats:
- WPD_OBJECT_FORMAT_BMP
- WPD_OBJECT_FORMAT_EXIF
- WPD_OBJECT_FORMAT_GIF
- WPD_OBJECT_FORMAT_ICON
- WPD_OBJECT_FORMAT_JFIF
- WPD_OBJECT_FORMAT_JP2
- WPD_OBJECT_FORMAT_JPX
- WPD_OBJECT_FORMAT_PNG
- WPD_OBJECT_FORMAT_TIFF
Optional content type: WPD_CONTENT_TYPE_DOCUMENT
Optional formats:
- WPD_OBJECT_FORMAT_HTML
- WPD_OBJECT_FORMAT_TEXT

Command syntax

Command option	Description
*te.exe wpdcompliance.dll /select:"@name='Events' and @TestClassification:Type='HCK'"*	Runs the test.