2.2.4.3 Change Participant Control Level PDU (OD_PARTICIPANT_CTRL_CHANGE)

The Change Participant Control Level PDU (OD_PARTICIPANT_CTRL_CHANGE) is sent by a participant to request a different control level. For instance, a view-only participant could ask the sharing manager to change its control level so that it can view and interact with shared content (section 3.3.5.2.3).


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

HDR

Flags

ParticipantId

...

HDR (4 bytes): The common PDU header (as specified in Common Order Header (section 2.2.1)). The Type field of the common PDU header MUST be set to ODTYPE_PARTICIPANT_CTRL_CHANGE (0x0009).

Flags (2 bytes): A 16-bit, unsigned integer that represents a set of bit flags, in little-endian format, that indicate participant requests for permission. A bit is true (or set) if its value is 1. This field MUST be composed of the bitwise OR of one or more of the following values.

Value

Meaning

REQUEST_VIEW

0x0001

The participant is requesting view permission.

REQUEST_INTERACT

0x0002

The participant is requesting interact permission.

ALLOW_CONTROL_REQUESTS

0x0008

The participant is requesting that "permission request" be allowed.

ParticipantId (4 bytes): A 32-bit, unsigned integer that specifies the unique identifier of the participant.