SecondaryBuffer.GetObjectInPath(Guid,Int32,Guid) Method (Microsoft.DirectX.DirectSound)
Retrieves a Microsoft DirectSound effect object at a particular index from a SecondaryBuffer object.
Definition
Visual Basic Public Function GetObjectInPath( _
ByVal guidObject As Guid, _
ByVal index As Integer, _
ByVal guidInterface As Guid
) As ObjectC# public object GetObjectInPath(
Guid
int index,
Guid
);C++ public:
Object
Guid
int index,
Guid
);JScript public function GetObjectInPath(
guidObject : Guid
index : int,
guidInterface : Guid
) : Object
Parameters
guidObject System.Guid
Unique class identifier of the object being searched for, such as DSoundHelper.StandardEchoGuid.index System.Int32
Index of DirectSound effect object to retrieve from the SecondaryBuffer object.guidInterface System.Guid
Unique identifier of the desired interface, such as DSoundHelper.InterfaceEffectsEcho
Return Value
System.Object
A DirectSound effect object, such as EchoEffect, from the SecondaryBuffer object you are searching.
Remarks
Any DMO that has been set on a buffer by using SetEffects method can be retrieved, even if it has not been allocated resources.
The following interfaces can be retrieved for the various DMOs supplied with Microsoft DirectX.
The value of the index is the index of the object within the array of effects passed to SetEffects. This is not necessarily the actual position of the object in the effects chain, because some effects might not have been created.
An object is returned solely on the basis of whether it matches guidObject and index. It is up to the application to ensure that guidInterface specifies an interface that can be expected to be found on the object.
Exceptions
An invalid parameter was passed to the called method.
The buffer control (volume, pan, and so on) requested by the caller is not available. Controls must be specified when the buffer is created.
The requested object was not found.
Root exception type for all DirectSound Exceptions. Derives from DirectXException.
See Also