Share via


Buffer.Read(Int32,Type,LockFlag,Int32[]) Method (Microsoft.DirectX.DirectSound)

Reads the current data in the buffer.

Definition

Visual Basic Public Function Read( _
    ByVal bufferStartingLocation As Integer, _
    ByVal returnedDataType As TypeLeave Site, _
    ByVal flag As LockFlag, _
    ByVal ranks() As Integer _
) As ArrayLeave Site
C# public ArrayLeave Site Read(
    int bufferStartingLocation,
    TypeLeave Site returnedDataType,
    LockFlag flag,
    int[] ranks
);
C++ public:
ArrayLeave SiteRead(
    int bufferStartingLocation,
    TypeLeave SitereturnedDataType,
    LockFlag flag,
    array<int>^ ranks
);
JScript public function Read(
    bufferStartingLocation : int,
    returnedDataType : TypeLeave Site,
    flag : LockFlag,
    ranks : int[]
) : ArrayLeave Site;

Parameters

bufferStartingLocation System.Int32
An integer that represents the offet, in bytes, of where to begin reading from the buffer. This parameter is ignored if LockFlag.FromWriteCursor is specified in the flag parameter.
returnedDataType System.Type
Value that indicates the TypeLeave Site of the returned array.
flag Microsoft.DirectX.DirectSound.LockFlag
A LockFlag enumerated value that describes the type of lock to perform.
ranks System.Int32[]
Array of one to three Int32Leave Site values that indicate the dimensions of the returning Array. The maximum number of ranks allowed is three.

Return Value

System.Array
An ArrayLeave Site of type returnDataType that contains the data read from the buffer.

Remarks

Exceptions

ArgumentExceptionLeave Site

An invalid parameter was passed to the called method, or numberBytesToRead is set to zero.

ArgumentNullExceptionLeave Site

One or more parameters is null.

ArgumentOutOfRangeExceptionLeave Site

The ranks parameter is out of range. The maximum number of dimensions for the ranks array is three.

BufferLostException

The buffer memory has been lost and must be restored.

InvalidCallException

The method call is invalid. For example, a method's parameter might not be valid.

NotSupportedExceptionLeave Site

Unable to write to the receiving stream object, data. Check if the stream is writable.

PriorityLevelNeededException

A cooperative level of Priority or higher is required.

Applies To

SecondaryBuffer