NAME

DL_ENABMULTI_REQ (dl_enabmulti_req_t) - requests the DLS Provider to enable specific multicast addresses on a per Stream basis. It is invalid for a DLS Provider to pass upstream messages that are destined for any address other than those explicitly enabled on that Stream by the DLS User.

SYNOPSIS

The message consists of one M_PROTO message block, which contains the following structure:

typedef struct {
    t_uscalar_t  dl_primitive;
    t_uscalar_t  dl_addr_length;
    t_uscalar_t  dl_addr_offset;
} dl_enabmulti_req_t;

PARAMETERS

dl_primitive

conveys DL_ENABMULTI_REQ

dl_addr_length

conveys the length of the multicast address

dl_addr_offset

conveys the offset from the beginning of the M_PROTO message block where the multicast address begins

STATE

This message is valid in any state in which a local acknowledgement is not pending with the exception of DL_UNATTACH.

NEW STATE

The resulting state is unchanged.

RESPONSE

If the enable request is successful, a DL_OK_ACK is sent to the DLS user. If the request fails, message DL_ERROR_ACK is returned and the resulting state is unchanged.

ERRORS

DL_BADADDR

Address information was invalid or was in an incorrect format.

DL_NOTSUPPORTED

The primitive is known, but not supported by the DLS Provider.

DL_OUTSTATE

The primitive was issued from an invalid state

DL_TOOMANY

Too many multicast address enable attempts. Limit exceeded.