Edit

Share via

IMFTimecodeTranslate::BeginConvertHNSToTimecode method (mfidl.h)

  • Article

Starts an asynchronous call to convert time in 100-nanosecond units to Society of Motion Picture and Television Engineers (SMPTE) time code.

Syntax

HRESULT BeginConvertHNSToTimecode(
  [in] MFTIME           hnsTime,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameters

[in] hnsTime

The time to convert, in 100-nanosecond units.

[in] pCallback

Pointer to the IMFAsyncCallback interface of a callback object. The caller must implement this interface.

[in] punkState

Pointer to the IUnknown interface of a state object, defined by the caller. This parameter can be NULL. You can use this object to hold state information. The object is returned to the caller when the callback is invoked.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
MF_E_SHUTDOWN
 The object's Shutdown method was called.
MF_E_BYTESTREAM_NOT_SEEKABLE
 The byte stream is not seekable. The time code cannot be read from the end of the byte stream.

Remarks

When the asynchronous method completes, the callback object's IMFAsyncCallback::Invoke method is called. At that point, the application must call IMFTimecodeTranslate::EndConvertHNSToTimecode to complete the asynchronous request.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header mfidl.h

See also

Calling Asynchronous Methods

IMFTimecodeTranslate

MFTIME