2.2.2.4.4.5 Give Control Reply

The Give Control Reply order accepts or declines the request of the receiver to give control to the sender.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

msg

hostControlId

mcsPassFrom

result

viewerControlId

msg (4 bytes): MUST contain the value 0x00000004.

hostControlId (4 bytes): The unique identifier that is used to match requests and replies. This field can contain any 32-bit value but MUST NOT contain 0. The value is not globally unique. This is generated in the local node by incrementing a UINT counter. The counter wraps around if necessary, but 0 is never a valid value.

mcsPassFrom (4 bytes): The user identifier who is passing control. This field MUST be set to 0x00000000 if the host is passing control.

result (4 bytes): One of the following values indicating the response of the sender.

Value

Meaning

CARESULT_CONFIRMED

0x00000000

The request was granted.

CARESULT_DENIED

0x00000001

The request was denied.

CARESULT_DENIED_BUSY

0x00000002

The request was denied because the user was occupied.

CARESULT_DENIED_USER

0x00000003

The request was denied because the user rejected the request.

CARESULT_DENIED_WRONGSTATE

0x00000004

The request was denied because the receiver was not in an acceptable state to accept control.

CARESULT_DENIED_TIMEOUT

0x00000005

The request was denied due to user time-out.

viewerControlId (4 bytes): The unique identifier that is used to match requests and replies. This field can contain any 32-bit value but MUST NOT contain 0. The value is not globally unique. This is generated in the local node by incrementing a UINT counter. The counter wraps around if necessary, but 0 is never a valid value.