Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectMusicScript8 Interface

The IDirectMusicScript8 interface represents a script containing variables that can be set and retrieved by the application, and routines that can be called by the application.

Typically the interface is obtained by using IDirectMusicLoader8::GetObject to load a script file. The application then calls IDirectMusicScript8::Init to associate the script with the DirectMusicPerformance object that performs the actual playback.

In addition to the methods inherited from IUnknown, the IDirectMusic8 interface exposes the following methods.

Method	Description
CallRoutine	Executes a routine in the script.
EnumRoutine	Retrieves the name of a routine in a script.
EnumVariable	Retrieves the name of a variable in a script.
GetVariableNumber	Retrieves a 32-bit signed value from a variable declared in the script.
GetVariableObject	Retrieves an object pointer from a variable declared in the script, or retrieves an object embedded or referenced in the script file.
GetVariableVariant	Retrieves a variant value from a variable declared in the script.
Init	Associates the script with the performance that will play the sounds.
SetVariableNumber	Assigns a 32-bit signed value to a variable declared in the script.
SetVariableObject	Assigns an object interface pointer to a variable declared in the script.
SetVariableVariant	Assigns a variant value to a variable declared in the script.

Requirements

Header: Dmusici.h
Library: Dmscript.dll, Dscripd.dll

See Also