IDirectMusicSegmentState8::GetSeek

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

IDirectMusicSegmentState8::GetSeek

The GetSeek method retrieves the seek pointer in the segment state. This is the value that is passed in the mtStart parameter of IDirectMusicTrack8::Play the next time that method is called. It does not take into account looping and repeating; if the entire segment state repeats to the beginning, the seek pointer is reset to 0.

Syntax

HRESULT GetSeek(
  MUSIC_TIME* pmtSeek
);

Parameters

pmtSeek

Address of a variable that receives the seek pointer.

Return Values

If the method succeeds, the return value is S_OK.

If the method fails, the return value can be E_POINTER.

Remarks

This method is not an accurate way of determining the current play position, because it seeks beyond the prepare time. For a better way to determine the current play position, see Pausing Segments.

Requirements

  Header: Declared in dmusici.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.