Platform SDK: DLC/NetBIOS

LLC_RECEIVE_PARMS

The LLC_RECEIVE_PARMS structure is the DLC parameter table for the LLC_RECEIVE command. You pass a pointer to this structure using the pParameterTable member of the CCB_PARMS union.

typedef struct {
  USHORT usStationId; 
  USHORT usUserLength; 
  ULONG ulReceiveFlag; 
  PLLC_BUFFER pFirstBuffer; 
  UCHAR uchOptions; 
  UCHAR auchReserved1[3]; 
  UCHAR uchRcvReadOption; 
} LLC_RECEIVE_PARMS, *PLLC_RECEIVE_PARMS;

Members

usStationId
SAP or link station identifier.
usUserLength
Length of user data in buffer.
ulReceiveFlag
The received data handler.
pFirstBuffer
Specifies the address of an LLC_BUFFER structure, representing the first buffer in the pool.
uchOptions
Defines how the frame is received. Specify one of the following values.
Option Description
LLC_CONTIGUOUS_MAC Contiguous MAC. Used only with MAC frames.
LLC_CONTIGUOUS_DATA Contiguous data. Only used with non-MAC frames. The system places the entire frame in the first buffer.
LLC_NOT_CONTIGUOUS_DATA The first data received is placed in the second buffer. The first buffer contains only the header data.

auchReserved1
Reserved.
uchRcvReadOption
Defines how RCV frames are chained. Specify one of the following values.
Option Description
LLC_RCV_READ_INDIVIDUAL_FRAMES The frames are not chained. Use an LLC_READ command to retrieve each frame.
LLC_RCV_CHAIN_FRAMES_ON_LINK The frames received for a link station are chained. You can use a single LLC_READ command to retrieve all chained frames.
LLC_RCV_CHAIN_FRAMES_ON_SAP The frames received for a SAP are chained. You can use a single LLC_READ command to retrieve all chained frames.

Remarks

If LLC_RECEIVE commands have been issued for link stations, the options specified for the link station's LLC_RECEIVE command determine how received data is chained. If a link station has a pending LLC_RECEIVE command specifying that its received frames should be chained on a link station basis, its frames will not be chained together with the SAP's frames. All link stations that do not have an LLC_RECEIVE command pending will have their received frames chained as specified by the SAP's LLC_RECEIVE command. If neither the SAP nor the link station have an LLC_RECEIVE command pending, the direct station is used.

The uchRcvReadOption member of a SAP's LLC_RECEIVE command is used to determine how data that the link station receives for the SAP is chained when its link stations do not have LLC_RECEIVE commands outstanding.

LLC_READ commands must match the LLC_RECEIVE commands uchRcvReadOption settings.

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, LLC_BUFFER