Share via

Camera Driver Controls System Test - Photo Sequence - Thumbnail

  • Article

This test validates cameras functionality if the driver supports KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE; if it does not, you should skip this test.

Note

   This is an optional control. If the driver does not support a control, you should not implement a control handler just to return an error. If a control handler is registered, the test expects the control to be fully functional.

 

If the driver implements the control handler, the following checks are run based on the definition of the controls by the camera topics document. (Note: Implementation of extended controls such as photo mode also requires the implementation of other extended controls; see Requirements and the camera topics document for details.)

  • Verifies default values (if appropriate).

  • Validates that a property is advertised on correct pin or filter level.

  • Enumerates possible control values while pins are streaming and not streaming.

  • Determines end-to-end functionality.

Startup latency is checked by the test measures by taking the delta between when the trigger was sent and when the sink received the first frame from the image pin. This is the PhotoSink_Time that is printed in the log if the test fails.

This test also validates photo frame rate by getting the value that the driver advertises on the get call of KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE. The test validates that the frame rate is within 10% of the advertised average frame rate. and that no frames are dropped during the photo sequence operation. Note that the min and max checks validate that a frame is no more than one-half of a frame early or late.

When KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE is set by the test, the driver should not exceed the frame rate that is passed in by the application. Note that this is a max frame rate, so the driver can do any frame rate that is lower than the one that is requested. Although when driver is queried for KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE, it should report its new value.

This test also validates that KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE is only advertised on the photo pin. If the driver receives a pin ID other than its photo pin. it should fail with ERROR_INVALID_PARAMETER.

Test details

   
Specifications
  • System.Client.Camera.Base.CameraControls
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows 10, client editions (Arm64)
  • Windows 10, mobile edition (Arm)
  • Windows 10, mobile edition (Arm64)
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) 15
Category Scenario
Timeout (in minutes) 25
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):

Running the test

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

Troubleshooting

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

For troubleshooting information, see Troubleshooting System Client Testing.

More information

Parameters

Parameter name Parameter description
DriverVerifierExcludedFlags Driver Verifier flags that may be manually excluded for the test run