Called when the Command Queue has determined that aCommand is in a position to be sent. This function gives the QDP the opportunity to send, block or reject the command.

The QDP should be careful not to cause a deadlock. This could happen if the decision is taken not to send command A if the command P is in the sent queue. However, if the completion of P depends on command A then the Command Queue would deadlock. For example, P = Connection Request Command and A = PIN Request Reply Command (in secmode 3).

CanSend can return a Symbian error code (not including KErrNone) to tell the Command Queue not to send a command. The obtained error code is send back to the command's originator. HCI error codes are represented within the Symbian error code range by subtracting the Bluetooth specification defined error code from KHCIErrorBase.

Returning KErrNone will result in the command being sent.

Note that the Command Queue will panic if the value returned is not a Symbian system-wide error code, a Symbian HCI error code (excluding EOK), or TCanSendAction::EBlock.

Called immediately prior to a command queue item being deleted to allow the QDP to clean up the items QDP data member.

Called when the timeout for a command has expired.

TCommandTimedOutAction

Queries whether a HCI command requires child commands to be sent before or after this parent command is sent for a workaround.

Retrieves the next faked event the QDP wishes to send (following a workaround) in order for it to keep the Stack synchronised with what may have been done (normally in the case where state cannot returned to how it was prior to the workaround, i.e. failures to succesfully perform the post-workaround stage)

For a faked event to be sent, the QDP should create a descriptor (of sufficient lifetime) that contains the raw data the event is to have. It should then use this to create an appropriate THCIEventBase class, which is to be returned as the faked event for the Command Queue to pass on.

This function will be repeatedly called (while the QDP continues to return faked events) so as to retrieve the sequence of faked events required. The previous faked event will be provided in the call to the QDP so that it does not need to maintain state about how far though the sequence of faked events it is.

When there are no (more) faked events required, a NULL pointer should be returned.

Retrieves the next post-child command for a parent command. A post-child command is a command that is to be sent to the HCTL after the parent command has been sent.

The aid the QDP in selecting the next command to be sent, it is passed the parent command and pointers to the previous child-command sent and its associated event. Note if the same command needs to be sent twice in a workaround, the QDP needs to create two different objects, as ownership of the resultant command is passed to the Command Queue.

Retrieves the next pre-child command for a parent command. A pre-child command is a command that is to be sent to the HCTL before the parent command is sent.

The aid the QDP in selecting the next command to be sent, it is passed the parent command and pointers to the previous child-command sent and its associated event. Note if the same command needs to be sent twice in a workaround, the QDP needs to create two different objects, as ownership of the resultant command is passed to the Command Queue.

Called to notify the QDP of an event that has been matched to a command. This function is intended as a way of the QDP keeping its state up-to-date. TCommandErroredAction

Called to notify the QDP of an event that has been matched to a command. This function is intended only as a way of the QDP keeping its state up-to-date.

Notifies the QDP of the Command Queue being reset.

This returns the initial number of command credits for the queue, which is typically one. However, some controllers send an event after reset to set credits so it could be zero.

Gives the QDP a reference to MHCICommandQueue, which allows it to add and remove commands when necessary

Gives the QDP a reference to MHardResetInitiator, which allows it to initiate a hard reset

Gives the QDP a reference to MPhysicalLinksState, which provides information that helps with decision making.

The QDP should make use of these values when informing the command queue of command completion timeouts. The QDP should be aware when choosing command completion timeouts, that choosing a value approaching the starvation timeout may result in panicing the queue. By default KMaxHciCommandTimeout is less than KQueueStarvationTimeout although this is configurable via the CmdQ.ini file. MhcqdiTimeoutRequired

Called immediately after a command has been sent to the controller allowing the QDP to keep its state up-to-date and specify a time-out for the command.

Called to notify the QDP of an event that does not have a matching command. This function is intended as a way of the QDP keeping its state up-to-date.

Note that this function will be called for both events that could legitimately be unexpected (unsolicited events), and those that are due to the controller sending us something odd e.g. providing a command status event for a command that has not been sent.

Represents the action that the QDP decides the Command Queue should take when a command is presented to the QDP ready to be sent, in the MhcqdiCanSend function. MhcqdiCanSend

Represents the action that the QDP decides the Command Queue should take when a command is matched to an event which signifies an error. MhcqdiMatchedErrorEventReceived

Represents the action that the QDP decides the Command Queue should take when the timeout for a command has expired. MhcqdiCommandTimedOut

Represents that no timer is required for the completion of a command.