2.2 Message Syntax

  • Article

The DSLR protocol uses a tag-based format for its messages. See [MS-DSLR] for the tag formats.

The DRMRI messages MUST follow the DSLR message syntax specified in [MS-DSLR] section 2.2.

The DSLR payload sent for a request is defined by the DSLR dispatcher request tag payload followed by the child payload, comprising the function parameters for the given message. The request tag payload includes the following:

  • The service handle for the specific service. See section 2.3 for how this service handle is obtained.

  • The function handle for the specific function being called on that service (defined by the service).

  • The calling convention for that function, and a one-time request handle allocated by the client for each request.

See section 2.2.1 for the format of the DSLR dispatcher request tag payload.

The DSLR payload for a response is defined by the DSLR dispatcher response tag payload, followed by the child payload that is the result and return parameters for the given message. The response tag payload includes the callingConvention parameter and the matching one-time request handle to which this response corresponds. See section 2.2.1 for the format of the DSLR dispatcher response tag payload.

The format of the data types used as input and output parameters in the following functions are defined in [MS-DSLR]. See section 2.2.1.6 for valid input/output parameters and how they are formatted on the wire, including big-endian or little-endian byte order.

For more details on the DSLR message syntax, see [MS-DSLR] section 2.2.

The child payloads (that is, the input/output parameters) for specific services are described in the following sections.