pdcomm_gem_result_spool_error_at
Function
Reads one stream error from a received S2F44 (Host).
PdcommStatus pdcomm_gem_result_spool_error_at(const PdcommGemResult *result, size_t index, uint8_t *stream, uint8_t *acknowledgement, PdcommSecsItem **functions)Parameters
| Name | Description |
|---|---|
result | #PDCOMM_GEM_SPOOL_CONFIG_ACK response result. |
index | Zero-based error index. |
stream | Receives the rejected stream; set to 0 first. Must not be NULL. |
acknowledgement | Receives STRACK: 1 spooling not allowed for the stream, 2 unknown stream, 3 unknown function, 4 secondary function. Set to 0 first. Must not be NULL. |
functions | Receives a new U1 item listing the offending functions. Set to NULL first. Must not be NULL. |
Returns
#PDCOMM_OK on success; #PDCOMM_INVALID_ARGUMENT when an argument is NULL; #PDCOMM_INVALID_STATE when the result is not an S2F44 response; #PDCOMM_OUT_OF_RANGE when index is past the end; #PDCOMM_INVALID_DATA, #PDCOMM_LIMIT_EXCEEDED, #PDCOMM_ALLOCATION_FAILED, or #PDCOMM_INTERNAL_ERROR.
Notes
- Ownership: release
*functionswith pdcomm_secs_destroy().