NAME

DL_SET_PHYS_ADDR_REQ (dl_set_phys_addr_req_t) - sets the physical address value for all streams for that provider for a particular PPA.

SYNOPSIS

The message consists of 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_set_phys_addr_req_t;

PARAMETERS

dl_primitive

conveys DL_SET_PHYS_ADDR_REQ.

dl_addr_offset

conveys the offset from the beginning of the M_PROTO message block.

dl_addr_length

conveys the length of the requested hardware address.

STATE

The message is valid in any attached state in which a local acknowledgement is not pending. For a Style 2 provider, this would be after a PPA is attached using the DL_ATTACH_REQ.For a Style 1 provider, the PPA is implicitly attached after the stream is opened.

NEW STATE

The resulting state is unchanged

RESPONSE

The provider responds to the request with a DL_OK_ACK on successful completion. Otherwise, a DL_ERROR_ACK is returned.

ERRORS

DL_BADADDR

The address information was invalid or was in an incorrect format.

DL_BUSY

One or more streams for that particular PPA are in the DL_BOUND state.

DL_NOTSUPPORTED

Primitive is known, but not supported by the DLS Provider.

DL_OUTSTATE

The primitive was issued from an invalid state.

DL_SYSERR

A system error has occurred