Platform SDK: DLC/NetBIOS

CCB_PARMS

The CCB_PARMS union represents the DLC parameter table. You can present the parameter table as a pointer to a structure, two USHORT values, an array of four UCHAR values, or a single ULONG value. You pass a pointer to this structure to the AcsLan function, through the u member of the LLC_CCB structure.

typedef union {
  PLLC_PARMS pParameterTable; 
  struct {
      USHORT usStationId;
      USHORT usParameter;
  } dlc;
  struct {
      USHORT usParameter0;
      USHORT usParameter1;
  } dir;
  UCHAR auchBuffer[4];
  ULONG ulParameter;
} CCB_PARMS;

Members

pParameterTable
Specifies a pointer to a structure in the LLC_PARMS union that represents the parameter table. The LLC_PARMS union represents all parameter table structures for DLC. The DLC command determines the particular structure to use, as shown in the following table.
Command Parameter table
LLC_BUFFER_CREATE LLC_BUFFER_CREATE_PARMS
LLC_BUFFER_FREE LLC_BUFFER_FREE_PARMS
LLC_BUFFER_GET LLC_BUFFER_GET_PARMS
LLC_DIR_INITIALIZE LLC_DIR_INITIALIZE_PARMS
LLC_DIR_OPEN_ADAPTER LLC_DIR_OPEN_ADAPTER_PARMS
LLC_DIR_OPEN_DIRECT LLC_DIR_OPEN_DIRECT_PARMS
LLC_DIR_READ_LOG LLC_DIR_READ_LOG_PARMS
LLC_DIR_SET_EXCEPTION_FLAGS LLC_DIR_SET_EFLAG_PARMS
LLC_DIR_SET_MULTICAST_ADDRESS LLC_DIR_MULTICAST_ADDRESS
LLC_DIR_STATUS LLC_DIR_STATUS_PARMS
LLC_DLC_CONNECT_STATION LLC_DLC_CONNECT_PARMS
LLC_DLC_MODIFY LLC_DLC_MODIFY_PARMS
LLC_DLC_OPEN_SAP LLC_DLC_OPEN_SAP_PARMS
LLC_DLC_OPEN_STATION LLC_DLC_OPEN_STATION_PARMS
LLC_DLC_REALLOCATE_STATIONS LLC_DLC_REALLOCATE_PARMS
LLC_DLC_SET_THRESHOLD LLC_DLC_SET_THRESHOLD_PARMS
LLC_DLC_STATISTICS LLC_DLC_STATISTICS_PARMS
LLC_READ LLC_READ_PARMS
LLC_RECEIVE LLC_RECEIVE_PARMS
LLC_TRANSMIT_DIR_FRAME LLC_TRANSMIT_PARMS
LLC_TRANSMIT_I_FRAME LLC_TRANSMIT_PARMS
LLC_TRANSMIT_TEST_CMD LLC_TRANSMIT_PARMS
LLC_TRANSMIT_UI_FRAME LLC_TRANSMIT_PARMS
LLC_TRANSMIT_XID_CMD LLC_TRANSMIT_PARMS
LLC_TRANSMIT_XID_RESP_FINAL LLC_TRANSMIT_PARMS
LLC_TRANSMIT_XID_RESP_NOT_FINAL LLC_TRANSMIT_PARMS

usStationId
Specifies the station identifier.
usParameter
Specifies an optional parameter.
usParameter0
The first optional parameter.
usParameter1
The second optional parameter.
auchBuffer
Specifies a group or functional address.
ulParameter
Specifies the parameter table.

Remarks

The following table shows how the usStationId, usParameter, usParameter0, usParameter1, auchBuffer, and ulParameter members are used by the commands whose parameter tables are not represented by a unique LLC_PARMS structure.

Command Parameter table
LLC_DIR_SET_FUNCTIONAL_ADDRESS usParameter0 and usParameter1 contain the address to be set or reset.
LLC_DIR_SET_GROUP_ADDRESS usParameter0 contains the group address to be set.
LLC_DIR_TIMER_CANCEL usParameter0 and usParameter1 contain the address of the timer to be canceled.
LLC_DIR_TIMER_CANCEL_GROUP usParameter0 and usParameter1 contain the timer completion flag.
LLC_DIR_TIMER_SET usParameter0 contains the timer value.
LLC_DLC_CLOSE_SAP usStationId contains the station identifier of the SAP to be closed and usParameter receives the station identifier of any link station on the SAP that is not closed.
LLC_DLC_CLOSE_STATION usStationId contains the station identifier of the station to be closed.
LLC_DLC_FLOW_CONTROL usStationId contains the station identifier and usParameter specifies one of the following options:

LLC_RESET_LOCAL_BUSY_USER
LLC_RESET_LOCAL_BUSY_BUFFER
LLC_SET_LOCAL_BUSY_USER

LLC_DLC_RESET usStationId contains the station identifier of the station to be reset. A value of zero defines all SAPs and all link stations. A value of 0xnn00 defines SAP nn and all its link stations.
LLC_READ_CANCEL ulParameter contains the address of the command control block of the read command to be canceled.
LLC_RECEIVE_CANCEL usStationId contains the station identifier of the SAP or link station of a pending LLC_RECEIVE command that is to be canceled.
LLC_RECEIVE_MODIFY usStationId contains the station identifier and usParameter specifies the length of the user data in the buffers.

Remarks

If an LLC_READ command is pending that requests notification of data to be received, the cancellation of the LLC_RECEIVE command does not affect the LLC_READ command. After the LLC_RECEIVE_CANCEL command completes, the pNext member of the LLC_CCB structure contains the address of the canceled LLC_RECEIVE command.

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