IWMReaderCallbackAdvanced::OnTime method
The OnTime method notifies the application of the clock time the reader is working to. This method is used when a user-provided clock has been specified.
Syntax
HRESULT OnTime(
QWORD cnsCurrentTime,
void *pvContext
);
Parameters
cnsCurrentTime
QWORD containing the current time in 100-nanosecond units.
pvContext
Generic pointer, for use by the application. This pointer is the context pointer given to the IWMReader::Start method.
Return value
To use this method, you must implement it in your application. You can return whatever HRESULT error codes are appropriate to your implementation. For more information about the HRESULT error codes included for use by the Windows Media Format SDK, see Error Codes.
Remarks
There are two cases in which callbacks indicating what the reader registers as the current elapsed time must be received by an application. The first case occurs when there are gaps in an ASF file (for example, no audio for 10 seconds). The OnTime method continues to be called, while OnSample does not. In the second case, if the application is driving the clock, the reader calls OnTime after it has delivered all the data up to the point requested by the application in a call to IWMReaderAdvanced::DeliverTime.
Requirements
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wmsdkidl.h (include Wmsdk.h) |