Wwise SDK 2018.1.11

Start streaming the first "in_pFSFlags->uNumBytesPrefetch" bytes of the file with id "in_fileID" into cache. The stream will be scheduled only after all regular streams (not file caching streams) are serviced. The file will stay cached until either the UnpinFileInCache is called, or the limit as set by uMaxCachePinnedBytes is reached and another higher priority file (in_uPriority) needs the space.

Remarks

PinFileInCache()/UnpinFileInCache()/UpdateCachingPriority() are typically not used directly, but instead used via the AK::SoundEngine::PinEventInStreamCache() API. Using PinFileInCache() directly does not allow users to take advantage of sound bank data. The file and the number of bytes they wish to cache must be explicitly specified.

See also

• Streaming / Stream Manager
• AK::SoundEngine::PinEventInStreamCache
• AK::SoundEngine::UnpinEventInStreamCache
• AkFileSystemFlags

Parameters

in_fileID	Application-defined ID
in_pFSFlags	Special file system flags (can NOT pass NULL)
in_uPriority	Stream caching priority. Note: Caching requests only get serviced after all regular streaming requests.