Microsoft DirectX 8.0 (C++)

IDirectMusicScript8::CallRoutine

スクリプト内のルーチンを実行する。

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

パラメータ

pwszRoutineName
ルーチンの名前。
pErrInfo
エラーが発生した場合に、情報を受け取る DMUS_SCRIPT_ERRORINFO 構造体のアドレス。エラー情報が必要でない場合は、このメンバに NULL を設定する。

戻り値

成功した場合は S_OK または DMUS_S_GARBAGE_COLLECTED を返す。「ガベージ コレクション」を参照すること。

失敗した場合は、次のいずれかの値を返す。

DMUS_E_NOT_INIT
DMUS_E_SCRIPT_ERROR_IN_SCRIPT
DMUS_E_SCRIPT_ROUTINE_NOT_FOUND
E_POINTER

注意

ルーチンの実行が終了するまでは、アプリケーションに制御が返らない。

動作環境

  ヘッダー : dmusici.h で宣言。