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.

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