AVC_VCR_CMD_TIME_CODE (Windows CE 5.0)
This command permits the caller to attempt to query the VCR subunit for the current time code value, based on the current position of inserted media, or to request that the VCR subunit attempt to search for a particular time code.
Parameters
- Command
This must be set to AVC_VCR_CMD_TIME_CODE. - CommandType
If the caller is attempting to query the time code for the current media position, this field should be set to AVC_VCR_CommandType_Status. If the caller is attempting to request a search for a particular time code, this field should be set to AVC_VCR_CommandType_Control. - u.TimeCode.Frame
If the caller is querying the current time code, this field need not be initialized. If the caller is requesting that the VCR search for a particular time code, this field should be initialized to the frame number of the time code the VCR should search for, or the value TIME_CODE_Frame_Unused in the event that the particular VCR does not utilize Frames, or if the Frame number is unknown. - u.TimeCode.Second
If the caller is querying the current time code, this field need not be initialized. If the caller is requesting that the VCR search for a particular time code, this field should be initialized to the second's value of the time code the VCR should search for. - u.TimeCode.Minute
If the caller is querying the current time code, this field need not be initialized. If the caller is requesting that the VCR search for a particular time code, this field should be initialized to the minute's value of the time code the VCR should search for. - u.TimeCode.Hour
If the caller is querying the current time code, this field need not be initialized. If the caller is requesting that the VCR search for a particular time code, this field should be initialized to the hour's value of the time code for which the VCR should search.
Return Values
- ResponseCode
The VCR subunit will return a specific value in this field, depending on the requested action and the capabilities of the subunits. A successful query will likely result in a value of AVC_RESPONSE_STABLE. A successful control attempt, a search attempt for this command, will result in a value of AVC_RESPONSE_ACCEPTED. Other values are possible and are discussed in the description of IOCTL_VCR_AVCCMD. - u.TimeCode.Frame
If the caller is querying the current time code, this field should contain the frame number of the time code representing the current position of the VCR on the inserted media. In the event that frames are unused or the frame value is unknown, the value TIME_CODE_Frame_Unused may be returned. - u.TimeCode.Second
If the caller is querying the current time code, this field should contain the second's value of the time code representing the current position of the VCR on the inserted media. - u.TimeCode.Minute
If the caller is querying the current time code, this field should contain the minute's value of the time code representing the current position of the VCR on the inserted media. - u.TimeCode.Hour
If the caller is querying the current time code, this field should contain the Hours value of the time code representing the current position of the VCR on the inserted media.
Remarks
Although reviewing the AV/C VCR Subunit Specification is an excellent resource for interpreting some of the finer details of these commands, it is not a conclusive guide. For example, all BCD values in the protocol are automatically translated for the caller by the TVPAK VCR subunit driver, so the caller should never expect nor provide a BCD value for a field.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Avc_vcr.h.
See Also
Send Feedback on this topic to the authors