This method retrieves the amount of time ahead that IDirectMusicTrack::Play is called before the messages is heard through the speakers. This interval allows sufficient time for the message to be processed by tools.

HRESULT GetPrepareTime(
  DWORD* pdwMilliSeconds


  • pdwMilliSeconds
    Address of a variable to receive the amount of prepare time.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return E_POINTER.


The default value is 1000 milliseconds.


OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.

See Also

Timing | IDirectMusicPerformance::SetPrepareTime | IDirectMusicTrack::Play

 Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.