IDirectMusicObject::ParseDescriptor
This method, given a file stream, scans the file for data that it can store in the DMUS_OBJECTDESC structure. All members that are supplied are marked with the appropriate flags in dwValidData.
This method is primarily used by the loader when scanning a directory for objects, and is not normally used directly by an application. However, if an application implements an object type in DirectMusic, it should support this method.
HRESULT ParseDescriptor(
LPSTREAM pStream,
LPDMUS_OBJECTDESC pDesc
);
Parameters
- pStream
Stream source for the file. - pDesc
Address of a DMUS_OBJECTDESC structure to receive data about the file.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
| DMUS_E_CHUNKNOTFOUND |
| DMUS_E_INVALID_BAND |
| DMUS_E_INVALIDFILE |
| DMUS_E_NOTADLSCOL |
| E_POINTER |
Requirements
OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.
See Also
IDirectMusicObject::SetDescriptor | DMUS_OBJECTDESC
Last updated on Monday, April 12, 2004
© 1992-2002 Microsoft Corporation. All rights reserved.