IDirectMusicStyle8::GetBand

Microsoft DirectX 9.0 SDK Update (Summer 2004)

The GetBand method retrieves a band specified by name.

Syntax

HRESULT GetBand(
  WCHAR* pwszName, 
  IDirectMusicBand** ppBand
);

Parameters

pwszName

Name of the band to retrieve. This name is created by the author of the style.

ppBand

Address of a variable that receives the IDirectMusicBand8 interface.

Return Values

If the method succeeds, the return value is S_OK if a band is returned, or S_FALSE if there is no band with that name.

If the method fails, the return value can be E_POINTER.

Requirements

Header: Declared in dmusici.h.

See Also