Microsoft DirectX 8.0 (C++)

IDirectMusicScript8::EnumVariable

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

HRESULT EnumVariable(
  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

注意

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

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

動作環境

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

参照

IDirectMusicScript8::EnumRoutine