DSDM_GETSTATUS

  • Article

This message retrieves the current status of the sound buffer.

typedef struct {
  DWORD dwMsg;
  DWORD dwInstance;
  PDWORD pdwStatus;
} DSDMP_GETSTATUS;

Members

  • dwMsg
    Equals DSDM_GETSTATUS.
  • dwInstance
    DirectSoundBuffer instance data.
  • pdwStatus
    Address of a variable to contain the status of the sound buffer. The status can be a combination of the following flags.
    Value Description
    DSBSTATUS_BUFFERLOST The buffer is lost and must be restored before it can be played or locked.
    DSBSTATUS_LOOPING The buffer is being looped. If this value is not set the buffer will stop when it reaches the end of the sound data. If the value is set the buffer must also be playing.
    DSBSTATUS_PLAYING The buffer is playing. If this value is not set the buffer is stopped.

Return Values

Returns DS_OK if successful, or DSERR_INVALIDPARAM if the method fails.

Remarks

No buffers are lost on Windows CE and DBSTATUS_BUFFERLOST is never returned from GetStatus.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Dsdriver.h.

See Also

DirectSound Driver Messages

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.