Microsoft DirectX 8.1 (C++)

IDirectMusicScript8

The IDirectMusicScript8 interface represents a script that contains 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.

Enumeration

Method Description
EnumRoutine Retrieves the name of a routine in a script.
EnumVariable Retrieves the name of a variable in a script.

Variables

Method Description
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.
GetVariableVariant Retrieves a variant value from a variable declared in the script.
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.

Miscellaneous

Method Description
CallRoutine Executes a routine in the script.
Init Associates the script with the performance that will play the sounds.

Requirements

  Header: Declared in dmusici.h.

See Also