Logo Search packages:      
Sourcecode: alsa-driver version File versions  Download package

HPI Error codes

Almost all HPI functions return an error code A return value of zero means there was no error. Otherwise one of these error codes is returned. Error codes can be converted to a descriptive string using HPI_GetErrorText()

Note:
When a new error code is added HPI_GetErrorText() MUST be updated.

Codes 1-100 are reserved for driver use

Enumerator:
HPI_ERROR_INVALID_TYPE  Message type does not exist.
HPI_ERROR_INVALID_OBJ  Object type does not exist.
HPI_ERROR_INVALID_FUNC  Function does not exist.
HPI_ERROR_INVALID_OBJ_INDEX  The specified object (adapter/Stream) does not exist.
HPI_ERROR_OBJ_NOT_OPEN  Trying to access an object that has not been opened yet.
HPI_ERROR_OBJ_ALREADY_OPEN  Trying to open an already open object.
HPI_ERROR_INVALID_RESOURCE  PCI, ISA resource not valid.
HPI_ERROR_SUBSYSFINDADAPTERS_GETINFO  GetInfo call from SubSysFindAdapters failed.
HPI_ERROR_INVALID_RESPONSE  Default response was never updated with actual error code.
HPI_ERROR_PROCESSING_MESSAGE  wSize field of response was not updated, indicating that the message was not processed.
HPI_ERROR_NETWORK_TIMEOUT  The network did not respond in a timely manner.
HPI_ERROR_INVALID_HANDLE  An HPI handle is invalid (uninitialised?).
HPI_ERROR_UNIMPLEMENTED  A function or attribute has not been implemented yet.
HPI_ERROR_NETWORK_TOO_MANY_CLIENTS  There are too many clients attempting to access a network resource.
HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL  Response buffer passed to HPI_Message was smaller than returned response
HPI_ERROR_RESPONSE_MISMATCH  The returned response did not match the sent message
HPI_ERROR_TOO_MANY_ADAPTERS  Too many adapters.
HPI_ERROR_BAD_ADAPTER  Bad adpater.
HPI_ERROR_BAD_ADAPTER_NUMBER  Adapter number out of range or not set properly.
HPI_DUPLICATE_ADAPTER_NUMBER  2 adapters with the same adapter number.
HPI_ERROR_DSP_BOOTLOAD  DSP code failed to bootload.
HPI_ERROR_DSP_SELFTEST  Adapter failed DSP code self test.
HPI_ERROR_DSP_FILE_NOT_FOUND  Couldn't find or open the DSP code file.
HPI_ERROR_DSP_HARDWARE  Internal DSP hardware error.
HPI_ERROR_DOS_MEMORY_ALLOC  Could not allocate memory in DOS.
HPI_ERROR_MEMORY_ALLOC  Could not allocate memory
HPI_ERROR_PLD_LOAD  Failed to correctly load/config PLD .
HPI_ERROR_DSP_FILE_FORMAT  Unexpected end of file, block length too big etc.
HPI_ERROR_DSP_FILE_ACCESS_DENIED  Found but could not open DSP code file.
HPI_ERROR_DSP_FILE_NO_HEADER  First DSP code section header not found in DSP file.
HPI_ERROR_DSP_FILE_READ_ERROR  File read operation on DSP code file failed.
HPI_ERROR_DSP_SECTION_NOT_FOUND  DSP code for adapter family not found.
HPI_ERROR_DSP_FILE_OTHER_ERROR  Other OS specific error opening DSP file.
HPI_ERROR_DSP_FILE_SHARING_VIOLATION  Sharing violation opening DSP code file.
HPI_ERROR_DSP_FILE_NULL_HEADER  DSP code section header had size == 0.
HPI_ERROR_FLASH  Base number for flash errors.
HPI_ERROR_BAD_CHECKSUM  Flash has bad checksum
HPI_ERROR_RESERVED_1  Reserved for OEMs.
HPI_ERROR_INVALID_STREAM  Stream does not exist.
HPI_ERROR_INVALID_FORMAT  Invalid compression format.
HPI_ERROR_INVALID_SAMPLERATE  Invalid format samplerate
HPI_ERROR_INVALID_CHANNELS  Invalid format number of channels.
HPI_ERROR_INVALID_BITRATE  Invalid format bitrate.
HPI_ERROR_INVALID_DATASIZE  Invalid datasize used for stream read/write.
HPI_ERROR_BUFFER_FULL  Stream buffer is full during stream write.
HPI_ERROR_BUFFER_EMPTY  Stream buffer is empty during stream read.
HPI_ERROR_INVALID_DATA_TRANSFER  Invalid datasize used for stream read/write.
HPI_ERROR_INVALID_PACKET_ORDER  Packet ordering error for stream read/write.
HPI_ERROR_INVALID_OPERATION  Object can't do requested operation in its current state, eg set format, change rec mux state while recording.
HPI_ERROR_INCOMPATIBLE_SAMPLERATE  Where an SRG is shared amongst streams, an incompatible samplerate is one that is different to any currently playing or recording stream.
HPI_ERROR_BAD_ADAPTER_MODE  Adapter mode is illegal.
HPI_ERROR_TOO_MANY_CAPABILITY_CHANGE_ATTEMPTS  There have been too many attempts to set the adapter's capabilities (using bad keys), the card should be returned to ASI if further capabilities updates are required
HPI_ERROR_NO_INTERADAPTER_GROUPS  Streams on different adapters cannot be grouped.
HPI_ERROR_NO_INTERDSP_GROUPS  Streams on different DSPs cannot be grouped.
HPI_ERROR_INVALID_NODE  Invalid mixer node for this adapter.
HPI_ERROR_INVALID_CONTROL  Invalid control.
HPI_ERROR_INVALID_CONTROL_VALUE  Invalid control value was passed.
HPI_ERROR_INVALID_CONTROL_ATTRIBUTE  Control attribute not supported by this control.
HPI_ERROR_CONTROL_DISABLED  Control is disabled.
HPI_ERROR_CONTROL_I2C_MISSING_ACK  I2C transaction failed due to a missing ACK.
HPI_ERROR_UNSUPPORTED_CONTROL_ATTRIBUTE  Control attribute is valid, but not supported by this hardware.
HPI_ERROR_CONTROL_NOT_READY  Control is busy, or coming out of reset and cannot be accessed at this time.
HPI_ERROR_NVMEM_BUSY  Non volatile memory
HPI_ERROR_I2C_MISSING_ACK  I2C
HPI_ERROR_ENTITY_TYPE_MISMATCH  Entity errors
HPI_ERROR_CUSTOM  custom error to use for debugging
HPI_ERROR_MUTEX_TIMEOUT  hpioct32.c can't obtain mutex
HPI_ERROR_BACKEND_BASE  errors from HPI backends have values >= this
HPI_ERROR_ILLEGAL_CACHE_VALUE  indicates a cached u16 value is invalid.

Definition at line 882 of file hpi.h.

                     {
      /** Message type does not exist. */
      HPI_ERROR_INVALID_TYPE = 100,
      /** Object type does not exist. */
      HPI_ERROR_INVALID_OBJ = 101,
      /** Function does not exist. */
      HPI_ERROR_INVALID_FUNC = 102,
      /** The specified object (adapter/Stream) does not exist. */
      HPI_ERROR_INVALID_OBJ_INDEX = 103,
      /** Trying to access an object that has not been opened yet. */
      HPI_ERROR_OBJ_NOT_OPEN = 104,
      /** Trying to open an already open object. */
      HPI_ERROR_OBJ_ALREADY_OPEN = 105,
      /** PCI, ISA resource not valid. */
      HPI_ERROR_INVALID_RESOURCE = 106,
      /** GetInfo call from SubSysFindAdapters failed. */
      HPI_ERROR_SUBSYSFINDADAPTERS_GETINFO = 107,
      /** Default response was never updated with actual error code. */
      HPI_ERROR_INVALID_RESPONSE = 108,
      /** wSize field of response was not updated,
      indicating that the message was not processed. */
      HPI_ERROR_PROCESSING_MESSAGE = 109,
      /** The network did not respond in a timely manner. */
      HPI_ERROR_NETWORK_TIMEOUT = 110,
      /** An HPI handle is invalid (uninitialised?). */
      HPI_ERROR_INVALID_HANDLE = 111,
      /** A function or attribute has not been implemented yet. */
      HPI_ERROR_UNIMPLEMENTED = 112,
      /** There are too many clients attempting to access a network resource. */
      HPI_ERROR_NETWORK_TOO_MANY_CLIENTS = 113,
      /** Response buffer passed to HPI_Message was smaller than returned response */
      HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL = 114,
      /** The returned response did not match the sent message */
      HPI_ERROR_RESPONSE_MISMATCH = 115,

      /** Too many adapters.*/
      HPI_ERROR_TOO_MANY_ADAPTERS = 200,
      /** Bad adpater. */
      HPI_ERROR_BAD_ADAPTER = 201,
      /** Adapter number out of range or not set properly. */
      HPI_ERROR_BAD_ADAPTER_NUMBER = 202,
      /** 2 adapters with the same adapter number. */
      HPI_DUPLICATE_ADAPTER_NUMBER = 203,
      /** DSP code failed to bootload. */
      HPI_ERROR_DSP_BOOTLOAD = 204,
      /** Adapter failed DSP code self test. */
      HPI_ERROR_DSP_SELFTEST = 205,
      /** Couldn't find or open the DSP code file. */
      HPI_ERROR_DSP_FILE_NOT_FOUND = 206,
      /** Internal DSP hardware error. */
      HPI_ERROR_DSP_HARDWARE = 207,
      /** Could not allocate memory in DOS. */
      HPI_ERROR_DOS_MEMORY_ALLOC = 208,
      /** Could not allocate memory */
      HPI_ERROR_MEMORY_ALLOC = 208,
      /** Failed to correctly load/config PLD .*/
      HPI_ERROR_PLD_LOAD = 209,
      /** Unexpected end of file, block length too big etc. */
      HPI_ERROR_DSP_FILE_FORMAT = 210,

      /** Found but could not open DSP code file. */
      HPI_ERROR_DSP_FILE_ACCESS_DENIED = 211,
      /** First DSP code section header not found in DSP file. */
      HPI_ERROR_DSP_FILE_NO_HEADER = 212,
      /** File read operation on DSP code file failed. */
      HPI_ERROR_DSP_FILE_READ_ERROR = 213,
      /** DSP code for adapter family not found. */
      HPI_ERROR_DSP_SECTION_NOT_FOUND = 214,
      /** Other OS specific error opening DSP file. */
      HPI_ERROR_DSP_FILE_OTHER_ERROR = 215,
      /** Sharing violation opening DSP code file. */
      HPI_ERROR_DSP_FILE_SHARING_VIOLATION = 216,
      /** DSP code section header had size == 0. */
      HPI_ERROR_DSP_FILE_NULL_HEADER = 217,

      /** Base number for flash errors. */
      HPI_ERROR_FLASH = 220,

      /** Flash has bad checksum */
      HPI_ERROR_BAD_CHECKSUM = (HPI_ERROR_FLASH + 1),
      HPI_ERROR_BAD_SEQUENCE = (HPI_ERROR_FLASH + 2),
      HPI_ERROR_FLASH_ERASE = (HPI_ERROR_FLASH + 3),
      HPI_ERROR_FLASH_PROGRAM = (HPI_ERROR_FLASH + 4),
      HPI_ERROR_FLASH_VERIFY = (HPI_ERROR_FLASH + 5),
      HPI_ERROR_FLASH_TYPE = (HPI_ERROR_FLASH + 6),
      HPI_ERROR_FLASH_START = (HPI_ERROR_FLASH + 7),

      /** Reserved for OEMs. */
      HPI_ERROR_RESERVED_1 = 290,

      /** Stream does not exist. */
      HPI_ERROR_INVALID_STREAM = 300,
      /** Invalid compression format. */
      HPI_ERROR_INVALID_FORMAT = 301,
      /** Invalid format samplerate */
      HPI_ERROR_INVALID_SAMPLERATE = 302,
      /** Invalid format number of channels. */
      HPI_ERROR_INVALID_CHANNELS = 303,
      /** Invalid format bitrate. */
      HPI_ERROR_INVALID_BITRATE = 304,
      /** Invalid datasize used for stream read/write. */
      HPI_ERROR_INVALID_DATASIZE = 305,
      /** Stream buffer is full during stream write. */
      HPI_ERROR_BUFFER_FULL = 306,
      /** Stream buffer is empty during stream read. */
      HPI_ERROR_BUFFER_EMPTY = 307,
      /** Invalid datasize used for stream read/write. */
      HPI_ERROR_INVALID_DATA_TRANSFER = 308,
      /** Packet ordering error for stream read/write. */
      HPI_ERROR_INVALID_PACKET_ORDER = 309,

      /** Object can't do requested operation in its current
      state, eg set format, change rec mux state while recording.*/
      HPI_ERROR_INVALID_OPERATION = 310,

      /** Where an SRG is shared amongst streams, an incompatible samplerate is one
      that is different to any currently playing or recording stream. */
      HPI_ERROR_INCOMPATIBLE_SAMPLERATE = 311,
      /** Adapter mode is illegal.*/
      HPI_ERROR_BAD_ADAPTER_MODE = 312,

      /** There have been too many attempts to set the adapter's
      capabilities (using bad keys), the card should be returned
      to ASI if further capabilities updates are required */
      HPI_ERROR_TOO_MANY_CAPABILITY_CHANGE_ATTEMPTS = 313,
      /** Streams on different adapters cannot be grouped. */
      HPI_ERROR_NO_INTERADAPTER_GROUPS = 314,
      /** Streams on different DSPs cannot be grouped. */
      HPI_ERROR_NO_INTERDSP_GROUPS = 315,

      /** Invalid mixer node for this adapter. */
      HPI_ERROR_INVALID_NODE = 400,
      /** Invalid control. */
      HPI_ERROR_INVALID_CONTROL = 401,
      /** Invalid control value was passed. */
      HPI_ERROR_INVALID_CONTROL_VALUE = 402,
      /** Control attribute not supported by this control. */
      HPI_ERROR_INVALID_CONTROL_ATTRIBUTE = 403,
      /** Control is disabled. */
      HPI_ERROR_CONTROL_DISABLED = 404,
      /** I2C transaction failed due to a missing ACK. */
      HPI_ERROR_CONTROL_I2C_MISSING_ACK = 405,
      /** Control attribute is valid, but not supported by this hardware. */
      HPI_ERROR_UNSUPPORTED_CONTROL_ATTRIBUTE = 406,
      /** Control is busy, or coming out of
      reset and cannot be accessed at this time. */
      HPI_ERROR_CONTROL_NOT_READY = 407,

      /** Non volatile memory */
      HPI_ERROR_NVMEM_BUSY = 450,
      HPI_ERROR_NVMEM_FULL = 451,
      HPI_ERROR_NVMEM_FAIL = 452,

      /** I2C */
      HPI_ERROR_I2C_MISSING_ACK = HPI_ERROR_CONTROL_I2C_MISSING_ACK,
      HPI_ERROR_I2C_BAD_ADR = 460,

      /** Entity errors */
      HPI_ERROR_ENTITY_TYPE_MISMATCH = 470,
      HPI_ERROR_ENTITY_ITEM_COUNT = 471,
      HPI_ERROR_ENTITY_TYPE_INVALID = 472,
      HPI_ERROR_ENTITY_ROLE_INVALID = 473,

      /* AES18 specific errors were 500..507 */

      /** custom error to use for debugging */
      HPI_ERROR_CUSTOM = 600,

      /** hpioct32.c can't obtain mutex */
      HPI_ERROR_MUTEX_TIMEOUT = 700,

      /** errors from HPI backends have values >= this */
      HPI_ERROR_BACKEND_BASE = 900,

      /** indicates a cached u16 value is invalid. */
      HPI_ERROR_ILLEGAL_CACHE_VALUE = 0xffff
};


Generated by  Doxygen 1.6.0   Back to index