KSPROPERTY_RAW_AVC_CMD

The KSPROPERTY_RAW_AVC_CMD property issues a raw AV/C command. Raw AV/C commands are supported only for IEEE 1394 bus devices.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Device

KSPROPERTY_EXTXPORT_S

Embedded RawAVC structure

 

The property value (operation data) is the embedded RawAVC member of the KSPROPERTY_EXTXPORT_S structure that describes the raw AV/C command to run.

Remarks

This property can only be used with devices that can support AV/C commands and where KSPROPERTY_EXTDEVICE_PORT returns DEV_PORT_1394 in the DevPort member of the KSPROPERTY_EXTDEVICE_S structure.

Driver developers for IEEE 1394 devices may optionally support this property in their drivers in order to extend the device transport controls that are not supported by standard interfaces (such as the user-mode IAMExtTransport COM interface methods put_Mode and get_Mode).

It is not necessary to implement support for this property on USB devices because the USB Video Class Driver provides this functionality. Normally applications can use the IKsControl COM interface to control an IEEE 1394 device. However, the IKsControl COM interface does not provide a standard method to support tape seek that is portable across USB and IEEE 1394 buses. Therefore, to perform a tape seek a caller must use the DeviceIoControl function instead of the IKsControl COM interface. Callers perform a tape seek on 1394 AV/C devices by using a raw AV/C command with an absolute track number (ATN) or time code to seek to. This is a primary reason why this property does not apply to USB devices.

See the Digital Video Application Compatibility white paper for more information about the differences between tape location searches on USB and 1394 devices.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY
KSPROPERTY_EXTXPORT_S

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft