Name

 
videoStreamGetPosition --- Retrieve current position of the specified video device channel
 
 

Syntax

 #include <mme/mme_api.h>
 MMRESULT videoStreamGetPosition(HVIDEO hVideo,
                                LPMMTIME lpInfo,
                                DWORD dwSize);
 

Arguments

 
HVIDEO hVideo
Specifies a handle to a video device channel.

 
LPMMTIME lpInfo
Specifies a pointer to an MMTIME data structure. 

The MMTIME data structure must be allocated with the mmeAllocMem function before being passed to the videoStreamGetPosition function. 
 
 
 
 
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures. 
 
 

 
DWORD dwSize
Specifies the size of the MMTIME data structure. 
 
 

Description

 
The videoStreamGetPosition function retrieves the current position of the specified video device channel.  The position is set to zero when streaming is started with the videoStreamStart function. 

 
Before using the videoStreamGetPosition function, set the wType field of the MMTIME data structure to indicate the desired time format. After the videoStreamGetPosition function returns, check the wType field to determine if the time format is supported.  If not, the wType field will specify an alternate format. Typically, the sample number time format is provided. 
 
 
 
 

Extensions

 
None.
 
 

Return Values

 
Returns DV_ERR_OK if the function is successful; otherwise, it returns the following error code:
 
 

 
DV_ERR_INVALHANDLE@T{ The specified device handle is invalid. T}

See Also

 
None.