IDirectMusicScript8 Interface

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 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: Declared in dmusici.h.

See Also

See Also


© 2004 Microsoft Corporation. All rights reserved.