Platform SDK: DLC/NetBIOS

LLC_TRANSMIT_PARMS

The LLC_TRANSMIT_PARMS structure is the DLC parameter table for the LLC_TRANSMIT commands. You pass a pointer to this structure using the pParameterTable member of the CCB_PARMS union.

typedef struct {
  USHORT usStationId;
  UCHAR uchTransmitFs;
  UCHAR uchRemoteSap;
  PLLC_XMIT_BUFFER pXmitQueue1;
  PLLC_XMIT_BUFFER pXmitQueue2;
  USHORT cbBuffer1;
  USHORT cbBuffer2;
  PVOID pBuffer1;
  PVOID pBuffer2;
  UCHAR uchXmitReadOption;
} LLC_TRANSMIT_PARMS, *PLLC_TRANSMIT_PARMS;

Members

usStationId
Specifies the station sending the data.
uchTransmitFs
The FS field returned by the adapter or protocol driver. On Ethernet, this field is zero. If the command succeeds, the return code is zero; otherwise, the return code is nonzero.
uchRemoteSap
The SAP value of the remote SAP that the local SAP is communicating with. This value is ignored if the sending station is a link station or a direct station.
pXmitQueue1
Specifies the address of the first (or only) buffer in a queue of buffers to be transmitted or NULL. The data in all buffers is transmitted as one frame.
pXmitQueue2
Specifies the address of the first (or only) buffer in a second queue of buffers to be transmitted or NULL. The data in all buffers is transmitted as one frame following the frame that contains the pXmitQueue1 buffers.
cbBuffer1
The length of the buffer for transmitting data pointed to by pBuffer1. If this member is zero, the cbBuffer2, pBuffer1, and pBuffer2 members are ignored.
cbBuffer2
The length of the buffer for transmitting data pointed to by pBuffer1. If this member is zero, this buffer is not used.
pBuffer1
Specifies the address of the buffer containing the data to be transmitted. The data is transmitted as one frame following the data in pXmitQueue1 and pXmitQueue2.
pBuffer2
Specifies the address of the buffer containing the data to be transmitted. The data is transmitted as one frame following the data in pXmitQueue1, pXmitQueue2, and pBuffer1.
uchXmitReadOption
Defines whether LLC_TRANSMIT commands are chained together when they complete. Specify one of the following values.
Option Description
LLC_CHAIN_XMIT_COMMANDS_ON_LINK Chain the command on a link station basis.
LLC_COMPLETE_SINGLE_XMIT_FRAME Do not chain the command.
LLC_CHAIN_XMIT_COMMANDS_ON_SAP Chain the command on a SAP station basis.

Remarks

This structure is used by all the LLC_TRANSMIT commands. The following table describes the information you must supply for each command.

Command Command specifics
LLC_TRANSMIT_DIR_FRAME The entire frame must be prepared by the application. The LAN header must reserve space for the adapter to insert the source address.
LLC_TRANSMIT_I_FRAME The only data supplied by the application is the actual data portion.
LLC_TRANSMIT_UI_FRAME The adapter provides the DLC header information. The application program must provide the LAN header and data portions of the message. The first buffer contains only the LAN header.
LLC_TRANSMIT_XID_CMD The user provides the LAN header and data portion. The user must leave room for the DLC header provided by the protocol driver. The first buffer must contain only the LAN header.
LLC_TRANSMIT_XID_RESP_FINAL The user provides the LAN header and data portion. The user must leave room for the DLC header provided by the protocol driver. The first buffer must contain only the LAN header.
LLC_TRANSMIT_XID_RESP_NOT_FINAL The user provides the LAN header and data portion. The user must leave room for the DLC header provided by the protocol driver. The first buffer must contain only the LAN header.
LLC_TRANSMIT_TEST_CMD The adapter provides the DLC header. The application program provides the LAN header and the optional test information. The first buffer must contain only the LAN header.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Dlcapi.h.

See Also

The DLC Interface Overview, DLC Structures, AcsLan, CCB_PARMS