IDirectMusicScript8::CallRoutine

The CallRoutine method executes a routine in the script.

Syntax

HRESULT CallRoutine(
  WCHAR *pwszRoutineName,
  DMUS_SCRIPT_ERRORINFO *pErrInfo
);

Parameters

pwszRoutineName

Name of the routine.

pErrInfo

Address of a DMUS_SCRIPT_ERRORINFO structure that receives information if an error occurs. Set this parameter to NULL if you do not want error information.

Return Values

If the method succeeds, the return value is S_OK or DMUS_S_GARBAGE_COLLECTED. See Garbage Collection.

If the method fails, return values can include those in the following table.

Remarks

Control does not return to the application until the routine finishes running.

Requirements

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

See Also

• IDirectMusicScript8 Interface
• Using Audio Scripts