Studio::Bank::getPath

Retrieves the path of the bank.

C++ Syntax

FMOD_RESULT Studio::Bank::getPath(
  char *path,
  int size,
  int *retrieved
);

C Syntax

FMOD_RESULT FMOD_Studio_Bank_GetPath(
  FMOD_STUDIO_BANK *bank,
  char *path,
  int size,
  int *retrieved
);

Parameters

path: Address of a buffer to receive the path. Specify 0 or NULL to ignore.
size: Size of the path buffer in bytes. Required if path parameter is not NULL.
retrieved: Address of a variable to receive the size of the retrieved path in bytes, including the terminating null character. Optional. Specify 0 or NULL to ignore.

Return Values

If the function succeeds then the return value is FMOD_OK.
If the function fails then the return value will be one of the values defined in the FMOD_RESULT enumeration.

Remarks

This function will return FMOD_ERR_EVENT_NOTFOUND unless string data for the requested bank is loaded (by loading the "Master Bank.strings.bank" file).

If the retrieved path is too long to fit in the supplied buffer, it will be truncated and this function will return FMOD_ERR_TRUNCATED. Use the retrieved parameter to obtain the minimum buffer size required to hold the full path.

Version 1.03.06 Built on Apr 17, 2014