CBasicAudio Class

The CBasicAudio class handles the IDispatch interface component of the IBasicAudio interface and leaves the properties and methods of IBasicAudio pure virtual to be implemented by a derived filter class.

The CBasicAudio::GetIDsOfNames, CBasicAudio::GetTypeInfo, CBasicAudio::GetTypeInfoCount, and CBasicAudio::Invoke member functions are standard implementations of the IDispatch interface using the CBaseDispatch class (and a type library) to parse the commands and pass them to the pure virtual IBasicAudio methods.

Microsoft® DirectShow™ uses units of 100th of a decibel for the volume scale. A value of 0 indicates maximum volume supported by the device. A value of –10,000 is the minimum volume (normally silence). Balance is expressed in the range –10,000 to 10,000, with 0 being neutral. A negative balance value means that the right channel is attenuated by this dB value (that is, it is quieter). Similarly, a positive balance value means that the right channel is louder than the left; that is, the left channel is attenuated by the corresponding negative decibel value.

Member Functions

Name	Description
CBasicAudio	Constructs a CBasicAudio object.

Implemented INonDelegatingUnknown Methods

Name	Description
NonDelegatingQueryInterface	Returns a specified reference-counted interface.

Implemented IDispatch Methods

Name	Description
GetIDsOfNames	Maps a single member and an optional set of parameters to a corresponding set of integer dispatch identifiers, which can be used during subsequent calls to the CBasicAudio::Invoke member function.
GetTypeInfo	Retrieves a type-information object, which can retrieve the type information for an interface.
GetTypeInfoCount	Retrieves the number of type-information interfaces provided by an object.
Invoke	Provides access to properties and methods exposed by an object.

---

CBasicAudio::CBasicAudio

Constructs a CBasicAudio object.

CBasicAudio(
  const TCHAR *pName,
  LPUNKNOWN pUnk
  );

Parameters

pName

Name of the object used in the CBasicAudio constructor for debugging purposes.

pUnk

Pointer to the owner of this object.

Return Values

No return value.

Remarks

Allocate the pName parameter in static memory. This name appears on the debugging terminal when the object is created and deleted.

---

CBasicAudio::GetIDsOfNames

Maps a single member function and an optional set of parameters to a corresponding set of integer dispatch identifiers, which can be used upon subsequent calls to the CBasicAudio::Invoke member function.

HRESULT GetIDsOfNames(
  REFIID riid,
  OLECHAR ** rgszNames,
  UINT cNames,
  LCID lcid,
  DISPID * rgdispid
  );

Parameters

riid

Reference identifier. Reserved for future use. Must be NULL.

rgszNames

Passed-in array of names to be mapped.

cNames

Count of the names to be mapped.

lcid

Locale context in which to interpret the names.

rgdispid

Caller-allocated array, each element of which contains an ID corresponding to one of the names passed in the rgszNames array. The first element represents the member name; the subsequent elements represent each of the member's parameters.

Return Values

Returns one of the following values.

Value	Meaning
DISP_E_UNKNOWN_CLSID	The CLSID was not recognized.
DISP_E_UNKNOWNNAME	One or more of the names were not known. The returned DISPIDs contain DISPID_UNKNOWN for each entry that corresponds to an unknown name.
E_OUTOFMEMORY	Out of memory.
S_OK	Success.

---

CBasicAudio::GetTypeInfo

Retrieves a type-information object, which can retrieve the type information for an interface.

HRESULT GetTypeInfo(
  UINT itinfo,
  LCID lcid,
  ITypeInfo ** pptinfo
  );

Parameters

itinfo

Type information to return. Pass zero to retrieve type information for the IDispatch implementation.

lcid

Locale ID for the type information. An object might be able to return different type information for different languages. This is important for classes that support localized member names. For classes that do not support localized member names, this parameter can be ignored.

pptinfo

Pointer to the type-information object requested.

Return Values

Returns an HRESULT value.

---

CBasicAudio::GetTypeInfoCount

Retrieves the number of type-information interfaces provided by an object.

HRESULT GetTypeInfoCount(
  UINT * pctinfo
  );

Parameters

pctinfo

Pointer to the location that receives the number of type-information interfaces that the object provides. If the object provides type information, this number is 1; otherwise, the number is 0.

Return Values

Returns an HRESULT value.

---

CBasicAudio::Invoke

Provides access to properties and methods exposed by an object.

HRESULT Invoke(
  DISPID dispidMember,
  REFIID riid,
  LCID lcid,
  WORD wFlags,
  DISPPARAMS * pdispparams,
  VARIANT * pvarResult,
  EXCEPINFO * pexcepinfo,
  UINT * puArgErr
  );

Parameters

dispidMember

Identifier of the member. Use CBasicAudio::GetIDsOfNames or the object's documentation to obtain the dispatch identifier.

riid

Reserved for future use. Must be IID_NULL.

lcid

Locale context in which to interpret arguments.

wFlags

Flags describing the context of the CBasicAudio::Invoke call.

pdispparams

Pointer to a structure containing an array of arguments, an array of argument dispatch IDs for named arguments, and counts for number of elements in the arrays.

pvarResult

Pointer to where the result is to be stored, or NULL if the caller expects no result.

pexcepinfo

Pointer to a structure containing exception information.

puArgErr

Index of the first argument, within the rgvarg array, that has an error.

Return Values

Returns an HRESULT value.

---

CBasicAudio::NonDelegatingQueryInterface

Returns a specified reference-counted interface.

HRESULT NonDelegatingQueryInterface(
  REFIID riid,
  void **ppv
  );

Parameters

riid

Reference identifier.

ppv

Pointer to the interface.

Return Values

Returns pointers to the IBasicAudio and IUnknown interfaces by default.

Remarks

Override this member function to publish any additional interfaces implemented by the derived class.

This member function implements the INonDelegatingUnknown::NonDelegatingQueryInterface method.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.