Windows Media Format SDK banner art
PreviousNext

IWMHeaderInfo::GetMarker

The GetMarker method returns the name and time of a marker, if its index is specified.

Syntax

HRESULT GetMarker(
  WORD  wIndex,
  WCHAR*  pwszMarkerName,
  WORD*  pcchMarkerNameLen,
  QWORD*  pcnsMarkerTime
);

Parameters

  wIndex

[in]  Word containing the index.

  pwszMarkerName

[out]  Pointer to a wide-character NULL-terminated string containing the marker name.

  pcchMarkerNameLen

[in]  On input, specifies a pointer to a variable containing the length of the pwszMarkerName array in wide characters (2 bytes). On output, and if the method succeeds, the variable contains the actual length of the name.

  pcnsMarkerTime

[out]  Pointer to a variable specifying the marker time in 100-nanosecond increments.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Meaning
NS_E_INVALID_STATE The writer is not in a configurable state.
E_UNEXPECTED The method failed for an unspecified reason.

Remarks

The writer does not support markers, and returns E_NOTIMPL.

See Also

PreviousNext


© 1999 Microsoft Corporation. All rights reserved.