Back to Card Commands
CMD_CARD_GET_SPEEDS 
Command:              CMD_CARD_GET_SPEEDS
Destination:          SD_CARD
Destination Channel:  Channel ID

Description

Clients use this command to retrieve a list of predefined network speeds for a channel.

Command data format

None.

Response data format

Set Speed IOCTL Get Speed IOCTL Speed data size (s) Number of entries (n) Speed #1 data .... Speed #n data
long (4bytes) long (4bytes) 1 byte 1 byte s bytes .... s bytes

Get Speed IOCTL: This returned value is the IOCTL number that may be used with the CMD_CARD_IOCTL command to manually retrieve the network timing parameters for this channel.

Set Speed IOCTL: This returned value is the IOCTL number that may be used with the CMD_CARD_IOCTL command to manually set the network timing parameters for this channel.

Speed Data Size: This field indicates the number of bytes of data associated with each predefined speed. This is also the number of data bytes that the above IOCTL commands will expect for this card.

Number of entries: This field indicates the number of predefined speed entries that exist for this channel.

Speed data fields: These fields include the actual speed data represented by each predefined speed; for example, the first speed data field includes the data used for speed index 1.

The presets listed in this table are used with the CMD_CARD_GET_SPEED and CMD_CARD_SET_SPEED commands. The index values that these two commands use as response or command data correspond to the predefined speed entries listed in the above table.

Sending CMD_CARD_SET_SPEED with index N is equivalent to sending CMD_CARD_IOCTL with ioctl number=Set Speed IOCTL from the above table and ioctl data = Speed # N data from the above table; data size is speed data size from the above table.

Sending CMD_CARD_GET_SPEED is equivalent to sending CMD_CARD_IOCTL with ioctl number = Get Speed IOCTL from the above table; data size returned will be speed data size from the above table.

Response return codes
RESP_OK Execution of the command was successful. (The requested information is returned in response data. For data content information, refer to the appropriate appendix for the expansion module being used.)
RESP_INVAL_CHAN The specified channel is invalid.
RESP_UNSUPPORTED This command is not supported on the specified channel.
RESP_UNREG The specified source channel is not registered with the server.
RESP_UNKNOWN_ERR An unknown error occurred.

|Top|