2.2.3.13 Sample Request

The Sample Request message is sent by the server over a device channel to request a video sample from the specified stream on the video capture device associated with the channel. For each Sample Request message received the client MUST send back either a Sample Response (section 2.2.3.14) message when a new sample is ready or a Sample Error Response (section 2.2.3.15) message if it failed to produce a sample.


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

Header

StreamIndex

Header (2 bytes): A SHARED_MSG_HEADER (section 2.2.1) structure. The Version field MUST be set to the same value as in the Select Version Response (section 2.2.2.2) message. The MessageId field MUST be set to SampleRequest (17).

StreamIndex (1 byte): An 8-bit unsigned integer containing the index of the stream being queried. This index MUST match the index in the STREAM_DESCRIPTION array returned in the Stream List Response (section 2.2.3.6) message.