DirectShow Interface

Table of Contents

• Supported Interfaces
  • IAMCameraControl
  • IAMDroppedFrames
  • IAMStreamConfig
  • IAMVideoProcAmp
  • IKsPropertySet
  • ISpecifyPropertyPages
• Logging
• Registering and renaming devices for DirectShow usage
  • Registering devices
  • Renaming devices
  • Make silent registration

Note

DirectShow can only be used in combination with the Microsoft Windows operating system.

Since Windows Vista, Movie Maker does not support capturing from a device registered for DirectShow anymore.

This is the documentation of the MATRIX VISION DirectShow_acquire interface. A MATRIX VISION specific property interface based on the IKsPropertySet has been added. All other features are related to standard DirectShow programming.

• Supported Interfaces
• Logging
• Registering and renaming devices for DirectShow usage

Supported Interfaces

IAMCameraControl

IAMDroppedFrames

IAMStreamConfig

IAMVideoProcAmp

IKsPropertySet

The DirectShow_acquire supports the IKsPropertySet Interface. For further information please refer to the Microsoft DirectX 9.0 Programmer's Reference.

Supported property set GUID's:

• AMPROPERTY_PIN_CATEGORY
• DIRECT_SHOW_ACQUIRE_PROPERTYSET

ISpecifyPropertyPages

Logging

The DirectShow_acquire logging procedure is equal to the logging of the MATRIX VISION products which uses mvIMPACT Acquire. The log output itself is based on XML.

If you want more information about the logging please have a look at the Logging chapter of the respective "mvIMPACT Acquire API" manual.

Registering and renaming devices for DirectShow usage

Note

Please be sure to register the MV device for DirectShow with the right version of mvDeviceConfigure . I.e. if you have installed the 32 bit version of the VLC Media Player, Virtual Dub, etc., you have to register the MV device with the 32 bit version of mvDeviceConfigure ("C:\Program Files\MATRIX VISION\mvIMPACT Acquire\bin") !

Registering devices

To register a device/devices for access under DirectShow please perform the following registration procedure:

1. Start mvDeviceConfigure.
   If no device has been registered the application will more or less (depending on the installed devices) look like this.
   
   
   
   Figure 1: mvDeviceConfigure - start window
   
   
2. To register every installed device for DirectShow access click on the menu item "DirectShow" → "Register all devices".
   
   
   
   Figure 2: mvDeviceConfigure - register all devices
   
   
3. After a successful registration the column "registered for DirectShow" will display 'yes' for every device and the devices will be registered with a default DirectShow friendly name.
   
   
   
   Figure 3: mvDeviceConfigure - registered devices
   
   

Renaming devices

If you want to modify the friendly name of a device under DirectShow, please perform the follwing procedure:

1. If mvDeviceConfigure is already not running, please start it.
2. Now, select the device you want to rename, click the right mouse button and select "Set DirectShow friendly name":
   
   
   
   Figure 4: mvDeviceConfigure - set DirectShow friendly name
   
   
3. Then, a dialog will appear. Please enter the new name and confirm it with "OK".
   
   
   
   Figure 5: mvDeviceConfigure - enter new name
   
   
4. Afterwards the column "DirectShow friendly name" will display the newly assigned friendly name.
   
   
   
   Figure 6: mvDeviceConfigure - renamed device
   
   

Note

Please do not select the same friendly name for two different devices. In theory this is possible, however the mvDeviceConfigure GUI will not allow this to avoid confusion.

Make silent registration

To make a silent registration without dialogs, the Windows tool "regsvr32" via command line can be used.

The following command line options are available an can be passed during the silent registration:

EXAMPLES:

Register ALL devices that are recognized by mvIMPACT Acquire (this will only register devices which have drivers installed).

regsvr32 <path>\DirectShow_acquire.ax /s