BufferDescription.CanGetCurrentPosition Property (Microsoft.DirectX.DirectSound)

  • Article

Determines whether the application can get a more accurate play cursor.

Definition

Visual Basic Public Property CanGetCurrentPosition As Boolean
C# public bool CanGetCurrentPosition { get; set; }
C++ public:
property bool CanGetCurrentPosition {
        bool get();
        void set(bool value);
}
JScript public function get CanGetCurrentPosition() : boolean
public function set CanGetCurrentPosition(boolean);

Property Value

System.Boolean
This value is set to true if the application can get a more accurate play cursor from the buffer; otherwise, false.

This property is read/write. 

Remarks

The Buffer.GetCurrentPosition method uses the new behavior of the play cursor. In Microsoft DirectSound included with Microsoft DirectX 1, the play cursor was significantly ahead of the actual playing sound on emulated sound cards; it was directly behind the write cursor. Now, if CanGetCurrentPosition is set to true, the application can get a more accurate play cursor. If this property is set to false, the old behavior is preserved for compatibility.

CanGetCurrentPosition affects only emulated sound cards. If a DirectSound driver is present, the play cursor is accurate for DirectSound in all versions of DirectX.