| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
DirectMusic Return Values by Name
The following list describes all DirectMusic return values. To find a constant from its value, see DirectMusic Return Values by Number.
Aggregation is not supported. The LPUNKNOWN parameter should be set to NULL.
The graph object was unable to load all tools from the IStream object data, perhaps because of errors in the stream or because the tools are incorrectly registered on the client.
The segment object was unable to load all tracks from the IStream object data, perhaps because of errors in the stream or because the tracks are incorrectly registered on the client.
The port has been activated, and the parameter cannot be changed.
The buffer has already been downloaded.
The tool is already contained in the graph. You must create a new instance.
The object has already been initialized.
A
The message has already been sent.
The port is not open.
The port is already open.
The audiopath is inactive, perhaps because the performance has been closed down.
The audiopath could not be created because a requested buffer could not be created.
DMUS_E_AUDIOPATH_NOGLOBALFXBUFFER
An attempt was made to create an audiopath that sends to a nonexistent global effects buffer.
The audiopath could not be used for playback because it lacked port assignments.
The performance has set up audiopaths, so
DMUS_E_AUDIOVBSCRIPT_OPERATIONFAILURE
A script routine written in AudioVBScript failed because a function outside the script failed to complete.
DMUS_E_AUDIOVBSCRIPT_RUNTIMEERROR
A script routine written in AudioVBScript failed because an invalid operation occurred—for example, adding an integer to an object, or attempting to call a routine that does not exist.
DMUS_E_AUDIOVBSCRIPT_SYNTAXERROR
A script routine written in AudioVBScript could not be read because it contained a statement not allowed by the language.
Invalid articulation chunk in
Invalid instrument chunk in
The offset table has errors.
Corrupt wave header.
The wave-link chunk in
There is no data in the buffer.
The specified number of bytes exceeds the maximum buffer size.
The buffer is not available for download.
No buffer was prepared for the data.
The requested conversion between music and MIDI values could not be made. This usually occurs when the provided DMUS_CHORD_KEY structure has an invalid chord or scale pattern.
The message could not be freed, either because it was not allocated or because it has already been freed.
The default system port could not be opened.
An error occurred when trying to read from the IStream object.
The IStream object does not support Seek.
The IStream object does not support Write.
A chunk with the specified header could not be found.
An attempt to descend into a chunk failed.
The device is in use, possibly by a non-DirectMusic client, and cannot be opened again.
The operation cannot be performed because the final instance of the DirectMusic object was released. Ports cannot be used after final release of the DirectMusic object.
An unexpected error was returned from a device driver, indicating possible failure of the driver or hardware.
A DirectSound object has already been set.
The port could not be created because no DirectSound object has been specified.
Getting the parameter is not supported.
The buffer is not large enough for the requested operation.
The file does not contain a valid band.
DMUS_E_INVALID_CONTAINER_OBJECT
The file does not contain a valid container object.
An invalid download identifier was used in the process of creating a download buffer.
The event either is not a valid MIDI message or makes use of running status and cannot be packed into the buffer.
The file contains an invalid lyrics track.
DMUS_E_INVALID_PARAMCONTROLTRACK
The file contains an invalid parameter control track.
The file contains an invalid script track.
DMUS_E_INVALID_SEGMENTTRIGGERTRACK
The file contains an invalid segment trigger track.
The IStream object's data contains an invalid tool header and cannot be read by the graph object.
The IStream object's data contains an invalid track header and cannot be read by the segment object.
An invalid DirectSound buffer was handed to a port.
Invalid data was found in a RIFF file chunk.
Not a valid file.
Wave chunks in the
No instrument in the collection matches the patch number.
Error reading wave data from a
The file path is invalid.
The object could not be found or created.
File open failed because the file does not exist or is locked.
DMUS_E_LOADER_FORMATNOTSUPPORTED
The object cannot be loaded because the data format is not supported.
No class identifier was supplied in the object description.
No file name was supplied in the object description.
The object was not found.
An attempt was made to play on a nonexistent audiopath.
The object does not contain an embedded audiopath configuration.
There is no master clock in the performance. Be sure to call the IDirectMusicPerformance8::Init method.
Articulation missing from an instrument in the
No sink is connected to the synthesizer.
The object cannot be unloaded because it is not present on the port.
The requested item is not contained by the object.
A required object is not initialized or failed to initialize.
An attempt to use this object failed because it was not loaded.
The object being loaded is not a valid
The wave chunk has more than one interleaved channel.
Waveform data is not in PCM format.
The requested time is outside the range of the segment.
The port is not a capture port.
The port is not an output port.
The requested operation cannot be performed while there are instantiated ports in any process in the system.
DMUS_E_SCRIPT_CANTLOAD_OLEAUT32
Loading of Oleaut32.dll failed. ActiveX scripting languages require use of oleaut32.dll. On platforms where this file is not present, only the AudioVBScript language can be used.
DMUS_E_SCRIPT_CONTENT_READONLY
Script variables for content referenced or embedded in a script cannot be set.
An error was encountered while parsing or executing the script.
The script file is invalid.
DMUS_E_SCRIPT_LANGUAGE_INCOMPATIBLE
The ActiveX scripting engine for the script's language is not compatible with DirectMusic.
DMUS_E_SCRIPT_LOADSCRIPT_ERROR
The script that was loaded contains an error.
An attempt was made to set a script's variable by reference to a value that is not an object type.
DMUS_E_SCRIPT_ROUTINE_NOT_FOUND
The script does not contain a routine with the specified name.
DMUS_E_SCRIPT_UNSUPPORTED_VARTYPE
A variant was used that had a type not supported by DirectMusic.
DMUS_E_SCRIPT_VALUE_NOT_SUPPORTED
An attempt was made to set a script's variable by value to an object that does not support a default value property.
DMUS_E_SCRIPT_VARIABLE_NOT_FOUND
The script does not contain a variable with the specified name.
Segment initialization failed, probably because of a critical memory situation.
Setting the parameter is not supported.
The synthesizer has been activated, and the parameter cannot be changed.
The synthesizer has not been activated and cannot process data.
The synthesizer is not properly configured or opened.
The time requested is in the past.
The stream object's data does not have a tool header as the first chunk and, therefore, cannot be read by the graph object.
The stream object's data does not have a track header as the first chunk and, therefore, cannot be read by the segment object.
DMUS_E_TRACK_NO_CLOCKTIME_SUPPORT
The track does not support clock-time playback or parameter retrieval.
There is no track of the requested type.
A track parameter is unavailable because it has been disabled.
Parameter is unsupported on this track.
The property set or item is not implemented by this port.
The synthesizer does not support this type of download.
The IStream object does not contain data supported by the loading object.
Invalid buffer format was handed to the synthesizer sink.
The note has been lowered by one or more octaves to fit within the range of MIDI values.
The operation succeeded and reached the end of the data.
The allocated memory should be freed.
The requested operation was not performed because the object has been released.
There are no more tools in the graph.
Although the audio output from the port is routed to the same device as the given DirectSound buffer, buffer controls such as pan and volume do not affect the output.
No MIDI values have been calculated because the music value has the note at a position higher than the top note of the chord.
Some instruments could not be downloaded to the port.
The object could only load partially. This can happen if some components, such as embedded tracks and tools, are not registered properly. It can also happen if some content is missing; for example, if a segment uses a
The message should be passed to the next tool.
The method succeeded, but the returned string was truncated.
The note has been raised by one or more octaves to fit within the range of MIDI values.
The method did not succeed.
Invalid argument. Often, this error results from failing to initialize the dwSize member of a structure before passing it to the method.
No object interface is available.
The method is not implemented. This value might be returned if a driver does not support a feature necessary for the operation.
Insufficient memory to complete the task.
An invalid pointer, usually NULL, was passed as a parameter.
The object class is not registered.
The method succeeded, but there was nothing to do.
The operation was completed successfully.
© 2004 Microsoft Corporation. All rights reserved.