Getting Object Descriptors

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

Getting Object Descriptors

After you have loaded an object, you can use its IDirectMusicObject8 interface to retrieve information about it in a DMUS_OBJECTDESC structure.

The following example function uses the IDirectMusicObject8::GetDescriptor method to obtain information about the name of a style:

void GetStyleName(IDirectMusicStyle8* pStyle)
{
  IDirectMusicObject8 *pIObject;
  DMUS_OBJECTDESC objDesc;
 
  if (SUCCEEDED(pStyle->QueryInterface(IID_IDirectMusicObject8,
      (void **) &pIObject)))
  {
    if (SUCCEEDED(pIObject->GetDescriptor(&objDesc)))
    {
      if (objDesc.dwValidData & DMUS_OBJ_NAME)
      {
        // Do something with objDesc.wszName, 
        // which now contains the name of the style.
      }
    }
    pIObject->Release();
  }
}

© 2004 Microsoft Corporation. All rights reserved.