Video Capture Filter Test (Compact 7)
3/12/2014
Functional tests for the video capture filter.
The Video Capture Filter Test tests directly the video capture filter, which exercises the camera driver. This test is ideal for component level testing of the camera driver via DirectShow, without involving the entire video capture graph. The test only exercises the first enumerated camera driver in the system.
You may want to run this test to test the integration of a camera driver into DirectShow, without involving the entire video capture graph and complex user scenarios.
Test Prerequisites
Your device must meet the following requirements before you run this test.
The following table shows the hardware requirement for the Video Capture Filter Test.
| Requirement | Description |
|---|---|
A DirectShow-compatible camera driver |
A DirectShow-compatible camera driver is required for this test. This can be specific to your hardware, or the NULL camera driver is available in the catalog for testing purposes. |
The following table shows the software requirements for the Video Capture Filter Test.
| Requirement | Description |
|---|---|
Tux.exe |
Test harness, required for test execution |
Kato.exe |
Logging engine, required for test execution |
Vidcaptest.dll |
Library containing the tests |
Subtests
The table below lists the subtests included in this test.
| SubTest ID | Description |
|---|---|
1000 |
Filter creation test Verifies filter creation |
1001 |
Pin enumerator test Verifies pin enumeration, and pin count |
1002 |
Query filter info test Verifies filter info |
1005 |
Sink ConnectDisconnect test Verifies filter connectivity to the test sink filter |
1007 |
Valid media combination test Verifies exposed media types are valid and connectable |
1008 |
Stop test - no streaming Verifies filter stopped state |
1009 |
Pause test - no streaming Verifies filter pause state |
1010 |
Run test - no streaming Verifies filter run state |
1011 |
Streaming test - Running, with verification Verifies filter delivery of samples and sample correctness |
1012 |
Flush test This filter doesn’t support flush, so this test should always skip |
1013 |
New segment test This filter doesn’t support new segments, so this test should always skip |
1100 |
QueryInterfaceTests Verifies required video capture filter interfaces |
1101 |
Pin QueryInterfaceTests Verifies required video capture filter interfaces for all output pins |
1102 |
PropertyBag driver load tests Verifies loadability of valid and invalid property bags |
1103 |
GetCLSIDTest Verifies the filter class id |
1104 |
PinFlowingTests Verifies the pins each deliver valid data |
1105 |
PinFlowingGraphStateTests Verifies the pins each deliver valid data and transition states correctly |
1106 |
StillPinTriggerTests Verifies the still pin delivers valid data |
1107 |
VidCap metadata tests |
Setting Up the Test
This test requires a camera that is Directshow compatible.
Running the Test
The Video Capture Filter Test executes the 's tux -o -d vidcaptest' command line on default execution.
There are currently no command line parameters for this test. The first camera driver enumerated in the system is tested.
Verifying the Test
When the test completes running, verify that "PASS" appears in the test log for all sub-tests.
Troubleshooting the Test
The following table shows troubleshooting tips for the Video Capture Filter Test.
| Item | Solution |
|---|---|
A failure loading the property bag |
The property bag containing the camera identifier will fail if the camera driver is not available. A test indication of a failure to load the property bag is most likely because there is no camera driver available or the driver has the incorrect device class GUID. |
For additional platform specific issues, consult the CTK articles on the TechNet wiki.