Share via


IAVTransport::Seek

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method begins seeking through the media associated with this AVTransport instance, using the specified seek unit and seek target.

Syntax

virtual DWORD Seek(
  LPCWSTR pszUnit,
  LPCWSTR pszTarget
) = 0;

Parameters

  • pszUnit
    [in] Type of seek operation, like seeking by track, by frame, and so on. Contains one of the SeekMode constants. Corresponds to the A_ARG_TYPE_SeekMode state variable.
  • pszTarget
    [in] Seek target, in units defined by the pszUnit parameter. Corresponds to the A_ARG_TYPE_SeekTarget state variable.

Return Value

Custom implementations can return appropriate error codes. Should return SUCCESS_AV if the method succeeds. Otherwise, should return an error code defined in WinError.h or UPnP.h, or one of the UPnP AV-specific return values specified in UPnPAVError, especially the following errors documented for this action in the AVTransport DCP documentation:

  • ERROR_AV_UPNP_AVT_INVALID_TRANSITION
  • ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED
  • ERROR_AV_UPNP_AVT_UNSUPPORTED_SEEK_MODE
  • ERROR_AV_UPNP_AVT_ILLEGAL_SEEK_TARGET
  • ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID

Remarks

This method corresponds to the AVTransport service's Seek action.

For more information about the actions in the AVTransport service, see UPnP AV DCP Documentation.

Requirements

Header av_upnp.h
Library Av_upnp.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IAVTransport
SeekMode
UPnPAVError