Microsoft DirectX 8.0 (C++)

IDirectMusicScript8::EnumRoutine

スクリプト内のルーチンの名前を取得する。このメソッドは、スクリプト内のすべてのルーチンを列挙する必要があるミュージック オーサリング アプリケーションが使用する。

HRESULT EnumRoutine(
  DWORD dwIndex, 
  WCHAR *pwszName
);

パラメータ

dwIndex
ルーチンの 0 から始まるインデックス。
pwszName
ルーチンの名前を受け取る文字列バッファへのポインタ。少なくても MAX_PATH 要素を含む必要がある。

戻り値

成功した場合は、次のいずれかのコードを返す。

S_OK ルーチンが列挙された。
S_FALSE 指定されたインデックス値を持つルーチンがない。
DMUS_S_GARBAGE_COLLECTED ガベージ コレクション」を参照すること。
DMUS_S_STRING_TRUNCATED 名前が MAX_PATH より長い。

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

DMUS_E_NOT_INIT
E_POINTER

注意

次のサンプルは、pScript が有効な IDirectMusicScript8 インターフェイス ポインタであり、スクリプト内のすべてのルーチンのインデックスと名前を表示する。

WCHAR wszRoutineName[MAX_PATH];
int i = 0;
while (S_OK == pScript->EnumRoutine(i++, wszRoutineName))
    printf("Routine number %d is called %S\n", i, wszRoutineName);

動作環境

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

参照

IDirectMusicScript8::EnumVariable