Wwise SDK

Writes data to a file (asynchronous).

Remarks

• Queue up your write request with address, size and file position specified in io_transferInfo.
• When transfer is complete (whether it was successful, cancelled or failed), call AkAsyncIOTransferInfo::pCallback. However, if you return AK_Fail() from Write(), do not call AkAsyncIOTransferInfo::pCallback.
• AkAsyncIOTransferInfo::pCookie must be passed to the callback function as-is. It must not be changed by the Low-Level I/O.
• The reference to io_transferInfo will be valid until the high-level device is notified through the callback.
• File position passed in io_transferInfo takes the offset of this file relative to AkFileDesc::hFile (described with AkFileDesc::uSector). It is computed by the high-level device as "in_fileDesc.uSector * Block_Size + Stream_Position", where Block_Size is obtained via AK::StreamMgr::IAkLowLevelIOHook::GetBlockSize().

Returns

• AK_Success: An I/O request was successfully processed and is pending: AkAsyncIOTransferInfo::pCallback must be called when it completes.
• AK_Fail: an error occured.

Parameters

in_fileDesc	File descriptor.
in_heuristics	Heuristics for this data transfer.
io_transferInfo	Platform-specific asynchronous IO operation info.

Referenced by BatchWrite().