#include <cafe.h> #include <cafe/hio.h> HIOStatus HIOWriteAsyncEx(HIOHandle handle, u32 sizeInBytes, const void *pData, HIOAsyncStruct *asyncStruct);
|handle||Channel to write.|
|sizeInBytes||Number of bytes to write.|
|pData||Pointer to the data to write.|
|asyncStruct||This parameter contains the callback function that will be called when the write completes or an error occurs.|
||Successfully submitted the asynchronous write request.|
||The asynchronous write request could not be submitted. Retry the request as the condition is temporary.|
||The asynchronous write request failed to be submitted.|
Invokes a write operation for the specified number of bytes on the channel designated by handle and returns immediately.
The callback function embedded in the asyncStruct parameter will be provided the number of bytes successfully written. The user must ensure that the number of bytes written matches the number of bytes specified by sizeInBytes. The user may have to issue another call to write the remaining data.
The asyncStruct parameter contains a pointer to the application callback
function as well as the
OSMessageQueue to use for communications that are
internal to the HostIO driver.
|Callbacks||Do not call this function from any callback function.|
|Interrupt handler||Do not call this function from any interrupt handler.|
|Exception handler||Do not call this function from any exception handler.|
|Production code||Do not call this function in production code. It is available only for debugging purposes.|
2013/05/08 Automated cleanup pass.
2012/04/11 Added const before void *.
2011/12/06 Added note regarding callback status code.
2011/11/04 Updated return values.
2011/02/21 Initial version.