Platform SDK: DLC/NetBIOS

LLC_READ_PARMS

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

typedef struct {
  USHORT usStationId;
  UCHAR uchOptionIndicator;
  UCHAR uchEventSet;
  UCHAR uchEvent;
  UCHAR uchCriticalSubset;
  ULONG ulNotificationFlag;
  union {
      struct {
          USHORT usCcbCount;
          PLLC_CCB pCcbCompletionList;
          USHORT usBufferCount;
          PLLC_BUFFER pFirstBuffer;
          USHORT usReceivedFrameCount;
          PLLC_BUFFER pReceivedFrame;
          USHORT usEventErrorCode;
          USHORT usEventErrorData[3];
      } Event;
      struct {
          USHORT usStationId;
          USHORT usDlcStatusCode;
          UCHAR uchFrmrData[5];
          UCHAR uchAccessPriority;
          UCHAR uchRemoteNodeAddress[6];
          UCHAR uchRemoteSap;
          UCHAR uchReserved;
          USHORT usUserStatusValue;
      } Status;
  } Type;

} LLC_READ_PARMS, *PLLC_READ_PARMS;

Members

usStationId
SAP station identifier.
uchOptionIndicator
Read option indicator. Specify one of the following values.
Value Description
LLC_OPTION_READ_STATION Match the read command using the station identifier.
LLC_OPTION_READ_SAP Match the read command using the SAP number of the station identifier.
LLC_OPTION_READ_ALL Match the read command using all events.

uchEventSet
Set of events for notification. Specify one of the following values.
Value Description
LLC_READ_ALL_EVENTS All events.
LLC_EVENT_SYSTEM_ACTION System action events.
LLC_EVENT_NETWORK_STATUS Network status events (non-critical).
LLC_EVENT_CRITICAL_EXCEPTION Critical exception.
LLC_EVENT_STATUS_CHANGE DLC status change.
LLC_EVENT_RECEIVE_DATA Receive data.
LLC_EVENT_TRANSMIT_COMPLETION Transmit completion.
LLC_EVENT_COMMAND_COMPLETION Command completion.

uchEvent
Posting event. Receives one of the LLC_EVENT constants described in uchEventSet.
uchCriticalSubset
Critical event subset identifier. This member receives one of the following values.
Value Description
1 Network status
2 Adapter check
3 System error
4 System action

ulNotificationFlag
Event user notification flag. This member receives the DLC status flag, as defined with the LLC_DLC_OPEN_SAP command, for the link station that experienced the change.
usCcbCount
Count of command control blocks chained to pCcbCompletionList.
pCcbCompletionList
Specifies the address of the command control blocks.
usBufferCount
Count of buffers chained to pFirstBuffer.
pFirstBuffer
Address of the first buffer of received data.
usReceivedFrameCount
Count of received frames chained to pReceivedFrame.
pReceivedFrame
Address of the received frame.
usEventErrorCode
Exception code.
usEventErrorData
Exception parameters.
usStationId
SAP or link station identifier.
usDlcStatusCode
DLC status code. This member receives one or more of the following values.
Code Name
0x8000 LLC_INDICATE_LINK_LOST
0x4000 LLC_INDICATE_DM_DISC_RECEIVED
0x2000 LLC_INDICATE_FRMR_RECEIVED
0x1000 LLC_INDICATE_FRMR_SENT
0x0800 LLC_INDICATE_RESET
0x0400 LLC_INDICATE_CONNECT_REQUEST
0x0200 LLC_INDICATE_REMOTE_BUSY
0x0100 LLC_INDICATE_REMOTE_READY
0x0080 LLC_INDICATE_TI_TIMER_EXPIRED
0x0040 LLC_INDICATE_DLC_COUTNER_OVERFLOW
0x0020 LLC_INDICATE_ACCESS_PRTY_LOWERED
0x0001 LLC_INDICATE_LOCAL_STATION_BUSY

uchFrmrData
Frame data.
uchAccessPriority
The new Token-Ring access priority. This value is not recognized on other networks.
uchRemoteNodeAddress
Remote node address.
uchRemoteSap
Remote SAP address.
uchReserved
Reserved.
usUserStatusValue
User status value.

Remarks

The following table shows which members are used for each event.

Event Members used
LLC_EVENT_SYSTEM_ACTION ulNotificationFlag
usCcbCount
pCcbCompletionList
usBufferCount
pFirstBuffer
usReceivedFrameCount
pReceivedFrame
usEventErrorCode
usEventErrorData
LLC_EVENT_NETWORK_STATUS ulNotificationFlag
usEventErrorCode
LLC_EVENT_CRITICAL_EXCEPTION uchCriticalSubset
ulNotificationFlag
usCcbCount
pCcbCompletionList
usBufferCount
pFirstBuffer
usReceivedFrameCount
pReceivedFrame
usEventErrorCode
usEventErrorData
LLC_EVENT_STATUS_CHANGE ulNotificationFlag
usStationId
usDlcStatusCode
uchFrmrData
uchAccessPriority
uchRemoteNodeAddress
uchRemoteSap
usUserStatusValue
LLC_EVENT_RECEIVE_DATA usReceivedFrameCount
pReceivedFrame
LLC_EVENT_TRANSMIT_COMPLETION usCcbCount
pCcbCompletionList
LLC_EVENT_COMMAND_COMPLETION usCcbCount
pCcbCompletionList
usBufferCount
pFirstBuffer
usReceivedFrameCount
pReceivedFrame

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