Top
PowerCOBOL V11.0 Reference
FUJITSU Software

4.297 TimeFormat Property

Description:

Defines the time units used in the MCI control. This affects the MediaPosition and MediaLength properties.

Used in control(s):

MCI

Values (with constants):

0 - Millisecond(POW-MCIFORMATMILLISECONDS)
2 - Minute/second/frame(POW-MCIFORMATMSF)
3 - Frame(POW-MCIFORMATFRAMES)
10 - Track/minute/second/frame(POW-MCIFORMATTMSF)

The value is undefined until the MCI driver is open.

Specifiable values vary between MCI drivers.

When TimeFormat is 0 or 3, the times are held as four byte quantities defining the number of milliseconds or frames.

When TimeFormat is 2, the data is stored in the lower three bytes:
Lowest order byte:Minutes
2nd lowest order byte:Seconds
3rd lowest order byte:Frames

When TimeFormat is 10, the data is stored in the four bytes:
Lowest order byte:Tracks
2nd lower order byte:Minutes
3rd lower order byte:Seconds
4th lower order byte:Frames

See the MediaLength Sample Code for an example of how to extract the track, minute, second and frame information.

Note:
For Intel 80x86 CPU platforms (the usual platform for Windows) low-high ordering of bytes is reversed compared to normal COBOL byte ordering. Using COMP-5 normally takes care of this for you, but you need to be aware of the reverse byte order when unpicking multiple bytes as in the above sample.

Default value:

None.

COBOL picture:

S9(4) COMP-5

OLE data type:

VT_I2

Design time access:

Not accessible.

Execution time access:

Set and reference.

Backward compatibility attribute:

POW-MCITIMEFORMATPIC S9(4) COMP-5