WPD Compliance Tests - Events (Manual)

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

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 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 HCK 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 HCK 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

Note  

For command-line help for this test binary, type /h.

File list

Send comments about this topic to Microsoft