Export (0) Print
Expand All
Expand Minimize

DEVCAPS structure

The DEVCAPS structure describes the capabilities of an external device.

Syntax


typedef struct tagDEVCAPS {
  LONG CanRecord;
  LONG CanRecordStrobe;
  LONG HasAudio;
  LONG HasVideo;
  LONG UsesFiles;
  LONG CanSave;
  LONG DeviceType;
  LONG TCRead;
  LONG TCWrite;
  LONG CTLRead;
  LONG IndexRead;
  LONG Preroll;
  LONG Postroll;
  LONG SyncAcc;
  LONG NormRate;
  LONG CanPreview;
  LONG CanMonitorSrc;
  LONG CanTest;
  LONG VideoIn;
  LONG AudioIn;
  LONG Calibrate;
  LONG SeekType;
  LONG SimulatedHardware;
} DEVCAPS, *PDEVCAPS;

Members

CanRecord

Specifies if the external device can record.

CanRecordStrobe

For multitrack devices. Specifies if the external device can record. Switches currently recording tracks off and selected nonrecording track into record.

HasAudio

Specifies if the external device has audio capabilities.

HasVideo

Specifies if the external device has video capabilities.

UsesFiles

Specifies if the external device uses files.

CanSave

Specifies if the external device can save.

DeviceType

Specifies the type of the external device. See Remarks.

FlagMeaning

ED_DEVTYPE_VCR

Video cassette recorder

ED_DEVTYPE_LASERDISC

Laserdisc player

ED_DEVTYPE_KEYBOARD

Keyboard

ED_DEVTYPE_CAMERA

Video camera

ED_DEVTYPE_VTR

Video tape recorder

ED_DEVTYPE_UNKNOWN

Unknown type

 

TCRead

Specifies if the external device can read timecodes.

TCWrite

Specifies if the external device can write timecodes.

CTLRead

Specifies if the external device can read to a control track (nontimecode) target value.

IndexRead

Specifies if the external device can read to an index (nontimecode) target value.

Preroll

Specifies the external device's preroll time in the current time format.

Postroll

Specifies the external device's postroll time in the current time format.

SyncAcc

Indicates the external device's synchronization accuracy.

NormRate

Specifies the external device's normal frame rate.

CanPreview

Specifies if the external device can preview.

CanMonitorSrc

Specifies if the external device can monitor source.

CanTest

Indicates the implementation of the external device allows testing of methods/parameters by setting the high bit of a parameter that makes sense. This is not implemented an always returns FALSE.

VideoIn

Indicates the external device accepts video as an input.

AudioIn

Indicates the external device accepts audio as an input.

Calibrate

Indicates if the external device requires calibrating.

SeekType

Specifies the type of seeking the external device is capable of. For example:

FlagMeaning

ED_SEEK_PERFECT

Indicates device can seek to within 1 video frame without a signal break (like a DDR).

ED_SEEK_FAST

Indicates device can seek quick with a short break in signal.

ED_SEEK_SLOW

Indicates slow seeking (like a tape transport).

 

SimulatedHardware

Must be set to zero.

Remarks

Any ED_Xxx tokens are defined in xprtdefs.h in the Microsoft DirectX SDK.

All members of the DEVCAPS structure are TRUE/FALSE unless otherwise specified.

The DeviceType member can be used by an application to detect the device type or its current operating mode. For example, it can return either ED_DEVTYPE_CAMERA or ED_DEVTYPE_VTR depending on a DV camcorder's mode of operation. Also, some DV devices may not be known and a device type of ED_DEVTYPE_UNKNOWN can be returned by the driver. This happens with some DV media converters.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

TIMECODE
KSPROPERTY_EXTDEVICE_S

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft