DlcAPI.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:33k
- /*++
- Copyright (c) 1991-1999 Microsoft Corporation
- Module Name:
- dlcapi.h
- Abstract:
- This module defines 32-bit Windows/NT DLC structures and manifests
- Revision History:
- --*/
- #ifndef _DLCAPI_
- #define _DLCAPI_
- #if _MSC_VER > 1000
- #pragma once
- #endif
- #ifdef __cplusplus
- extern "C" {
- #endif
- //
- // DLC Command Codes
- //
- #define LLC_DIR_INTERRUPT 0x00
- #define LLC_DIR_OPEN_ADAPTER 0x03
- #define LLC_DIR_CLOSE_ADAPTER 0x04
- #define LLC_DIR_SET_MULTICAST_ADDRESS 0x05
- #define LLC_DIR_SET_GROUP_ADDRESS 0x06
- #define LLC_DIR_SET_FUNCTIONAL_ADDRESS 0x07
- #define LLC_DIR_READ_LOG 0x08
- #define LLC_TRANSMIT_FRAMES 0x09
- #define LLC_TRANSMIT_DIR_FRAME 0x0A
- #define LLC_TRANSMIT_I_FRAME 0x0B
- #define LLC_TRANSMIT_UI_FRAME 0x0D
- #define LLC_TRANSMIT_XID_CMD 0x0E
- #define LLC_TRANSMIT_XID_RESP_FINAL 0x0F
- #define LLC_TRANSMIT_XID_RESP_NOT_FINAL 0x10
- #define LLC_TRANSMIT_TEST_CMD 0x11
- #define LLC_DLC_RESET 0x14
- #define LLC_DLC_OPEN_SAP 0x15
- #define LLC_DLC_CLOSE_SAP 0x16
- #define LLC_DLC_REALLOCATE_STATIONS 0x17
- #define LLC_DLC_OPEN_STATION 0x19
- #define LLC_DLC_CLOSE_STATION 0x1A
- #define LLC_DLC_CONNECT_STATION 0x1B
- #define LLC_DLC_MODIFY 0x1C
- #define LLC_DLC_FLOW_CONTROL 0x1D
- #define LLC_DLC_STATISTICS 0x1E
- #define LLC_DIR_INITIALIZE 0x20
- #define LLC_DIR_STATUS 0x21
- #define LLC_DIR_TIMER_SET 0x22
- #define LLC_DIR_TIMER_CANCEL 0x23
- #define LLC_BUFFER_GET 0x26
- #define LLC_BUFFER_FREE 0x27
- #define LLC_RECEIVE 0x28
- #define LLC_RECEIVE_CANCEL 0x29
- #define LLC_RECEIVE_MODIFY 0x2A
- #define LLC_DIR_TIMER_CANCEL_GROUP 0x2C
- #define LLC_DIR_SET_EXCEPTION_FLAGS 0x2D
- #define LLC_BUFFER_CREATE 0x30
- #define LLC_READ 0x31
- #define LLC_READ_CANCEL 0x32
- #define LLC_DLC_SET_THRESHOLD 0x33
- #define LLC_DIR_CLOSE_DIRECT 0x34
- #define LLC_DIR_OPEN_DIRECT 0x35
- #define LLC_MAX_DLC_COMMAND 0x37
- //
- // forward definitions
- //
- union _LLC_PARMS;
- typedef union _LLC_PARMS LLC_PARMS, *PLLC_PARMS;
- //
- // Parameters. Can be pointer to a parameter table (32-bit flat address),
- // a single 32-bit ULONG, 2 16-bit USHORTs or 4 8-bit BYTEs
- //
- typedef union {
- PLLC_PARMS pParameterTable; // pointer to the parameter table
- struct {
- USHORT usStationId; // Station id
- USHORT usParameter; // optional parameter
- } dlc;
- struct {
- USHORT usParameter0; // first optional parameter
- USHORT usParameter1; // second optional parameter
- } dir;
- UCHAR auchBuffer[4]; // group/functional address
- ULONG ulParameter;
- } CCB_PARMS;
- //
- // LLC_CCB - the Command Control Block structure
- //
- typedef struct _LLC_CCB {
- UCHAR uchAdapterNumber; // Adapter 0 or 1
- UCHAR uchDlcCommand; // DLC command
- UCHAR uchDlcStatus; // DLC command completion code
- UCHAR uchReserved1; // reserved for DLC DLL
- struct _LLC_CCB* pNext; // CCB chain
- ULONG ulCompletionFlag; // used in command completion
- CCB_PARMS u; // parameters
- HANDLE hCompletionEvent; // event for command completion
- UCHAR uchReserved2; // reserved for DLC DLL
- UCHAR uchReadFlag; // set when special READ CCB chained
- USHORT usReserved3; // reserved for DLC DLL
- } LLC_CCB, *PLLC_CCB;
- //
- // transmit/receive buffers
- //
- union _LLC_BUFFER;
- typedef union _LLC_BUFFER LLC_BUFFER, *PLLC_BUFFER;
- typedef struct {
- PLLC_BUFFER pNextBuffer; // next DLC buffer in frame
- USHORT cbFrame; // length of the whole received frame
- USHORT cbBuffer; // length of this segment
- USHORT offUserData; // offset of data from descriptor header
- USHORT cbUserData; // length of the data
- } LLC_NEXT_BUFFER;
- typedef struct {
- PLLC_BUFFER pNextBuffer; // next buffer of frame
- USHORT cbFrame; // length of entire frame
- USHORT cbBuffer; // length of this buffer
- USHORT offUserData; // user data in this struct
- USHORT cbUserData; // length of user data
- USHORT usStationId; // ssnn station id
- UCHAR uchOptions; // option byte from RECEIVE param tbl
- UCHAR uchMsgType; // the message type
- USHORT cBuffersLeft; // number of basic buffer units left
- UCHAR uchRcvFS; // the reveived frame status
- UCHAR uchAdapterNumber; // adapter number
- PLLC_BUFFER pNextFrame; // pointer to next frame
- UCHAR cbLanHeader; // length of the lan header
- UCHAR cbDlcHeader; // length of the DLC header
- UCHAR auchLanHeader[32]; // lan header of the received frame
- UCHAR auchDlcHeader[4]; // dlc header of the received frame
- USHORT usPadding; // data begins from offset 64 !!!
- } LLC_NOT_CONTIGUOUS_BUFFER;
- typedef struct {
- PLLC_BUFFER pNextBuffer; // next buffer of frame
- USHORT cbFrame; // length of entire frame
- USHORT cbBuffer; // length of this buffer
- USHORT offUserData; // user data in this struct
- USHORT cbUserData; // length of user data
- USHORT usStationId; // ssnn station id
- UCHAR uchOptions; // option byte from RECEIVE param tbl
- UCHAR uchMsgType; // the message type
- USHORT cBuffersLeft; // number of basic buffer units left
- UCHAR uchRcvFS; // the reveived frame status
- UCHAR uchAdapterNumber; // adapter number
- PLLC_BUFFER pNextFrame; // pointer to next frame
- } LLC_CONTIGUOUS_BUFFER;
- //
- // Received frames are returned in these data structures
- //
- union _LLC_BUFFER {
- PLLC_BUFFER pNext;
- LLC_NEXT_BUFFER Next;
- struct LlcNextBuffer {
- LLC_NEXT_BUFFER Header;
- UCHAR auchData[];
- } Buffer;
- LLC_NOT_CONTIGUOUS_BUFFER NotContiguous;
- struct {
- LLC_NOT_CONTIGUOUS_BUFFER Header;
- UCHAR auchData[];
- } NotCont;
- LLC_CONTIGUOUS_BUFFER Contiguous;
- struct {
- LLC_CONTIGUOUS_BUFFER Header;
- UCHAR auchData[];
- } Cont;
- };
- //
- // This structure is used by BUFFER.GET, BUFFER.FREE and TRANSMIT
- //
- struct _LLC_XMIT_BUFFER;
- typedef struct _LLC_XMIT_BUFFER LLC_XMIT_BUFFER, *PLLC_XMIT_BUFFER;
- struct _LLC_XMIT_BUFFER {
- PLLC_XMIT_BUFFER pNext; // next buffer (or NULL)
- USHORT usReserved1; //
- USHORT cbBuffer; // length of transmitted data
- USHORT usReserved2; //
- USHORT cbUserData; // length of optional header
- UCHAR auchData[]; // optional header and transmitted data
- };
- #define LLC_XMIT_BUFFER_SIZE sizeof(LLC_XMIT_BUFFER)
- //
- // CCB parameter tables
- //
- typedef struct {
- HANDLE hBufferPool; // handle of new buffer pool
- PVOID pBuffer; // any buffer in memory
- ULONG cbBufferSize; // buffer size in bytes
- ULONG cbMinimumSizeThreshold; // minimum locked size
- } LLC_BUFFER_CREATE_PARMS, *PLLC_BUFFER_CREATE_PARMS;
- typedef struct {
- USHORT usReserved1; // Station id is not used
- USHORT cBuffersLeft; // free 256 buffer segments
- ULONG ulReserved;
- PLLC_XMIT_BUFFER pFirstBuffer; // buffer chain
- } LLC_BUFFER_FREE_PARMS, *PLLC_BUFFER_FREE_PARMS;
- typedef struct {
- USHORT usReserved1; // Station id is not used
- USHORT cBuffersLeft; // free 256 buffer segments
- //
- // cBuffersToGet: number of buffers to get. If 0, the returned buffer list
- // may consist of segment of different size
- //
- USHORT cBuffersToGet;
- //
- // cbBufferSize: size of the requested buffers. This will be rounded up to
- // the next largest segment size: 256, 512, 1024, 2048 or 4096
- //
- USHORT cbBufferSize;
- PLLC_XMIT_BUFFER pFirstBuffer;
- } LLC_BUFFER_GET_PARMS, *PLLC_BUFFER_GET_PARMS;
- //
- // parameter table for DLC.CONNECT.STATION
- //
- typedef struct {
- USHORT usStationId; // SAP or direct station ID, defines the pool
- USHORT usReserved;
- PUCHAR pRoutingInfo; // offset to the routing info
- } LLC_DLC_CONNECT_PARMS, *PLLC_DLC_CONNECT_PARMS;
- //
- // DLC_FLOW_CONTROL Options:
- //
- #define LLC_RESET_LOCAL_BUSY_USER 0x80
- #define LLC_RESET_LOCAL_BUSY_BUFFER 0xC0
- #define LLC_SET_LOCAL_BUSY_USER 0
- typedef struct {
- USHORT usRes;
- USHORT usStationId; // SAP or link station id
- UCHAR uchT1; // response timer
- UCHAR uchT2; // aknowledgment timer
- UCHAR uchTi; // inactivity timer
- UCHAR uchMaxOut; // max transmits without ack
- UCHAR uchMaxIn; // max receives without ack
- UCHAR uchMaxOutIncr; // dynamic window increment value
- UCHAR uchMaxRetryCnt; // N2 value (retries)
- UCHAR uchReserved1;
- USHORT usMaxInfoFieldLength; // Only for link stations, NEW!!!
- UCHAR uchAccessPriority; // token ring access priority
- UCHAR auchReserved3[4];
- UCHAR cGroupCount; // number of group SAPs of this SAP
- PUCHAR pGroupList; // offset to the group list
- } LLC_DLC_MODIFY_PARMS, *PLLC_DLC_MODIFY_PARMS;
- #define LLC_XID_HANDLING_IN_APPLICATION 0x08
- #define LLC_XID_HANDLING_IN_DLC 0
- #define LLC_INDIVIDUAL_SAP 0x04
- #define LLC_GROUP_SAP 0x02
- #define LLC_MEMBER_OF_GROUP_SAP 0x01
- typedef struct {
- USHORT usStationId; // SAP or link station id
- USHORT usUserStatValue; // reserved for user
- UCHAR uchT1; // response timer
- UCHAR uchT2; // aknowledgment timer
- UCHAR uchTi; // inactivity timer
- UCHAR uchMaxOut; // max tramists without ack
- UCHAR uchMaxIn; // max receives without ack
- UCHAR uchMaxOutIncr; // dynamic window increment value
- UCHAR uchMaxRetryCnt; // N2 value (retries)
- UCHAR uchMaxMembers; // maximum members for group SAP
- USHORT usMaxI_Field; // maximum length of the Info field
- UCHAR uchSapValue; // SAP value to be assigned
- UCHAR uchOptionsPriority; // SAP options and access priority
- UCHAR uchcStationCount; // maximum number of link stations in sap
- UCHAR uchReserved2[2]; //
- UCHAR cGroupCount; // number of group SAPs of this SAP
- PUCHAR pGroupList; // offset to the group list
- ULONG DlcStatusFlags; // User notify flag for DLC status changes
- UCHAR uchReserved3[8]; // reserved
- UCHAR cLinkStationsAvail; // total number of available link stations
- } LLC_DLC_OPEN_SAP_PARMS, *PLLC_DLC_OPEN_SAP_PARMS;
- typedef struct {
- USHORT usSapStationId; // SAP station id
- USHORT usLinkStationId; // Link station id
- UCHAR uchT1; // response timer
- UCHAR uchT2; // aknowledgment timer
- UCHAR uchTi; // inactivity timer
- UCHAR uchMaxOut; // max tramists without ack
- UCHAR uchMaxIn; // max receives without ack
- UCHAR uchMaxOutIncr; // dynamic window increment value
- UCHAR uchMaxRetryCnt; // N2 value (retries)
- UCHAR uchRemoteSap; // remote SAP of the link
- USHORT usMaxI_Field; // max I field length
- UCHAR uchAccessPriority; // token ring access priority
- PVOID pRemoteNodeAddress; // pointer to the destination address
- } LLC_DLC_OPEN_STATION_PARMS, *PLLC_DLC_OPEN_STATION_PARMS;
- #define LLC_INCREASE_LINK_STATIONS 0
- #define LLC_DECREASE_LINK_STATIONS 0x80
- typedef struct {
- USHORT usStationId; // ID of affected SAP
- UCHAR uchOption; // increase of decrease indicator
- UCHAR uchStationCount;
- UCHAR uchStationsAvailOnAdapter;
- UCHAR uchStationsAvailOnSap;
- UCHAR uchTotalStationsOnAdapter;
- UCHAR uchTotalStationsOnSap;
- } LLC_DLC_REALLOCATE_PARMS, *PLLC_DLC_REALLOCATE_PARMS;
- typedef struct {
- USHORT usStationId; // SAP station ID
- USHORT cBufferThreshold; // SAP buffer pool Threshold number
- PVOID AlertEvent; // alerting event
- } LLC_DLC_SET_THRESHOLD_PARMS, *PLLC_DLC_SET_THRESHOLD_PARMS;
- typedef struct {
- PVOID TraceBuffer; // trace buffer
- ULONG TraceBufferSize; // trace buffer size
- ULONG TraceFlags; // various trace flags
- } LLC_TRACE_INITIALIZE_PARMS, *PLLC_TRACE_INITIALIZE_PARMS;
- #define LLC_DLC_RESET_STATISTICS 0x80
- #define LLC_DLC_READ_STATISTICS 0
- typedef struct {
- ULONG cTransmittedFrames;
- ULONG cReceivedFrames;
- ULONG cDiscardedFrames;
- ULONG cDataLost;
- USHORT cBuffersAvailable;
- } DLC_SAP_LOG, *PDLC_SAP_LOG;
- typedef struct {
- USHORT cI_FramesTransmitted;
- USHORT cI_FramesReceived;
- UCHAR cI_FrameReceiveErrors;
- UCHAR cI_FrameTransmissionErrors;
- USHORT cT1_ExpirationCount; // Note: not OUT data xfer mode
- UCHAR uchLastCmdRespReceived;
- UCHAR uchLastCmdRespTransmitted;
- UCHAR uchPrimaryState;
- UCHAR uchSecondaryState;
- UCHAR uchSendStateVariable;
- UCHAR uchReceiveStateVariable;
- UCHAR uchLastNr; // last received NR
- UCHAR cbLanHeader;
- UCHAR auchLanHeader[32];
- } DLC_LINK_LOG, *PDLC_LINK_LOG;
- typedef union {
- DLC_SAP_LOG Sap;
- DLC_LINK_LOG Link;
- } LLC_DLC_LOG_BUFFER, *PLLC_DLC_LOG_BUFFER;
- typedef struct {
- USHORT usStationId; // ID of a SAP or a link station
- USHORT cbLogBufSize; //
- PLLC_DLC_LOG_BUFFER pLogBuf; // offset to the log buffer
- USHORT usActLogLength; // length of returned log
- UCHAR uchOptions; // command options (bit7 resets log params)
- } LLC_DLC_STATISTICS_PARMS, *PLLC_DLC_STATISTICS_PARMS;
- typedef struct {
- USHORT usBringUps; // Token Ring adapter bring up error code
- UCHAR Reserved[30]; // everything else specific to DOS or OS/2
- } LLC_DIR_INITIALIZE_PARMS, *PLLC_DIR_INITIALIZE_PARMS;
- typedef struct {
- USHORT usOpenErrorCode; // open adapter errors detected
- USHORT usOpenOptions; // various options
- UCHAR auchNodeAddress[6]; // adapters LAN address
- UCHAR auchGroupAddress[4]; // multicast address added in the open
- UCHAR auchFunctionalAddress[4]; // added token ring functional address
- USHORT usReserved1;
- USHORT usReserved2;
- USHORT usMaxFrameSize; // maximum frame size defined in NDIS
- USHORT usReserved3[4];
- USHORT usBringUps; // Bring up errors, TR only
- USHORT InitWarnings;
- USHORT usReserved4[3];
- } LLC_ADAPTER_OPEN_PARMS, *PLLC_ADAPTER_OPEN_PARMS;
- typedef struct {
- UCHAR uchDlcMaxSaps;
- UCHAR uchDlcMaxStations;
- UCHAR uchDlcMaxGroupSaps;
- UCHAR uchDlcMaxGroupMembers;
- UCHAR uchT1_TickOne; // Short timer interval (for 1 - 5)
- UCHAR uchT2_TickOne;
- UCHAR uchTi_TickOne;
- UCHAR uchT1_TickTwo; // Long timer interval (for 6 - 10)
- UCHAR uchT2_TickTwo;
- UCHAR uchTi_TickTwo;
- } LLC_DLC_PARMS, *PLLC_DLC_PARMS;
- //
- // The ethernet mode selects the LAN header format of ethernet. SNA
- // applications should use the default parameter, that has been defined in the
- // registry. The applications using connectionless DLC services should select
- // the ethernet LLC LAN header format they are using (usually 802.3)
- //
- typedef enum {
- LLC_ETHERNET_TYPE_DEFAULT, // use the parameter value set in registry
- LLC_ETHERNET_TYPE_AUTO, // automatic header type selction for links
- LLC_ETHERNET_TYPE_802_3, // use always 802.3 lan headers
- LLC_ETHERNET_TYPE_DIX // use always LLC on DIX SNA type.
- } LLC_ETHERNET_TYPE, *PLLC_ETHERNET_TYPE;
- typedef struct {
- PVOID hBufferPool;
- PVOID pSecurityDescriptor;
- LLC_ETHERNET_TYPE LlcEthernetType;
- } LLC_EXTENDED_ADAPTER_PARMS, *PLLC_EXTENDED_ADAPTER_PARMS;
- typedef struct {
- PLLC_ADAPTER_OPEN_PARMS pAdapterParms; // ADAPTER_PARMS
- PLLC_EXTENDED_ADAPTER_PARMS pExtendedParms; // DIRECT_PARMS
- PLLC_DLC_PARMS pDlcParms; // DLC_PARMS
- PVOID pReserved1; // NCB_PARMS
- } LLC_DIR_OPEN_ADAPTER_PARMS, *PLLC_DIR_OPEN_ADAPTER_PARMS;
- typedef struct {
- UCHAR auchMulticastAddress[6]; // 48 bit multicast address
- } LLC_DIR_MULTICAST_ADDRESS, *PLLC_DIR_MULTICAST_ADDRESS;
- #define LLC_DIRECT_OPTIONS_ALL_MACS 0x1880
- typedef struct {
- USHORT Reserved[4];
- USHORT usOpenOptions;
- USHORT usEthernetType;
- ULONG ulProtocolTypeMask;
- ULONG ulProtocolTypeMatch;
- USHORT usProtocolTypeOffset;
- } LLC_DIR_OPEN_DIRECT_PARMS, *PLLC_DIR_OPEN_DIRECT_PARMS;
- typedef struct {
- UCHAR cLineError;
- UCHAR cInternalError;
- UCHAR cBurstError;
- UCHAR cAC_Error;
- UCHAR cAbortDelimiter;
- UCHAR uchReserved1;
- UCHAR cLostFrame;
- UCHAR cReceiveCongestion;
- UCHAR cFrameCopiedError;
- UCHAR cFrequencyError;
- UCHAR cTokenError;
- UCHAR uchReserved2;
- UCHAR uchReserved3;
- UCHAR uchReserved4;
- } LLC_ADAPTER_LOG_TR, *PLLC_ADAPTER_LOG_TR;
- typedef struct {
- UCHAR cCRC_Error;
- UCHAR uchReserved1;
- UCHAR cAlignmentError;
- UCHAR uchReserved2;
- UCHAR cTransmitError;
- UCHAR uchReserved3;
- UCHAR cCollisionError;
- UCHAR cReceiveCongestion;
- UCHAR uchReserved[6];
- } LLC_ADAPTER_LOG_ETH, *PLLC_ADAPTER_LOG_ETH;
- typedef union {
- LLC_ADAPTER_LOG_TR Tr;
- LLC_ADAPTER_LOG_ETH Eth;
- } LLC_ADAPTER_LOG, *PLLC_ADAPTER_LOG;
- typedef struct {
- ULONG cTransmittedFrames;
- ULONG cReceivedFrames;
- ULONG cDiscardedFrames;
- ULONG cDataLost;
- USHORT cBuffersAvailable;
- } LLC_DIRECT_LOG, *PLLC_DIRECT_LOG;
- typedef union {
- LLC_ADAPTER_LOG Adapter;
- LLC_DIRECT_LOG Dir;
- struct {
- LLC_ADAPTER_LOG Adapter;
- LLC_DIRECT_LOG Dir;
- } both;
- } LLC_DIR_READ_LOG_BUFFER, *PLLC_DIR_READ_LOG_BUFFER;
- #define LLC_DIR_READ_LOG_ADAPTER 0
- #define LLC_DIR_READ_LOG_DIRECT 1
- #define LLC_DIR_READ_LOG_BOTH 2
- typedef struct {
- USHORT usTypeId; // 0=adapter, 1=direct, 2=both logs
- USHORT cbLogBuffer; // size of log buffer
- PLLC_DIR_READ_LOG_BUFFER pLogBuffer;// pointer to log buffer
- USHORT cbActualLength; // returned size of log buffer
- } LLC_DIR_READ_LOG_PARMS, *PLLC_DIR_READ_LOG_PARMS;
- typedef struct {
- ULONG ulAdapterCheckFlag;
- ULONG ulNetworkStatusFlag;
- ULONG ulPcErrorFlag;
- ULONG ulSystemActionFlag;
- } LLC_DIR_SET_EFLAG_PARMS, *PLLC_DIR_SET_EFLAG_PARMS;
- #define LLC_ADAPTER_ETHERNET 0x0010
- #define LLC_ADAPTER_TOKEN_RING 0x0040
- typedef struct {
- UCHAR auchPermanentAddress[6]; // permanent encoded address
- UCHAR auchNodeAddress[6]; // adapter's network address
- UCHAR auchGroupAddress[4]; // adapter's group address
- UCHAR auchFunctAddr[4]; // adapter's functional address
- UCHAR uchMaxSap; // maximum allowable SAP
- UCHAR uchOpenSaps; // number of currently open saps
- UCHAR uchMaxStations; // max number of stations (always 253)
- UCHAR uchOpenStation; // number of open stations (only up to 253)
- UCHAR uchAvailStations; // number of available stations (always 253)
- UCHAR uchAdapterConfig; // adapter configuration flags
- UCHAR auchReserved1[10]; // microcode level
- ULONG ulReserved1;
- ULONG ulReserved2;
- ULONG ulMaxFrameLength; // maximum frame length (only in Windows/Nt)
- USHORT usLastNetworkStatus;
- USHORT usAdapterType; // THIS BYTE IS NOT USED IN DOS DLC !!!
- } LLC_DIR_STATUS_PARMS, *PLLC_DIR_STATUS_PARMS;
- #define LLC_OPTION_READ_STATION 0
- #define LLC_OPTION_READ_SAP 1
- #define LLC_OPTION_READ_ALL 2
- #define LLC_EVENT_SYSTEM_ACTION 0x0040
- #define LLC_EVENT_NETWORK_STATUS 0x0020
- #define LLC_EVENT_CRITICAL_EXCEPTION 0x0010
- #define LLC_EVENT_STATUS_CHANGE 0x0008
- #define LLC_EVENT_RECEIVE_DATA 0x0004
- #define LLC_EVENT_TRANSMIT_COMPLETION 0x0002
- #define LLC_EVENT_COMMAND_COMPLETION 0x0001
- #define LLC_READ_ALL_EVENTS 0x007F
- //
- // LLC_STATUS_CHANGE indications
- // The returned status value may be an inclusive-OR of several flags
- //
- #define LLC_INDICATE_LINK_LOST 0x8000
- #define LLC_INDICATE_DM_DISC_RECEIVED 0x4000
- #define LLC_INDICATE_FRMR_RECEIVED 0x2000
- #define LLC_INDICATE_FRMR_SENT 0x1000
- #define LLC_INDICATE_RESET 0x0800
- #define LLC_INDICATE_CONNECT_REQUEST 0x0400
- #define LLC_INDICATE_REMOTE_BUSY 0x0200
- #define LLC_INDICATE_REMOTE_READY 0x0100
- #define LLC_INDICATE_TI_TIMER_EXPIRED 0x0080
- #define LLC_INDICATE_DLC_COUNTER_OVERFLOW 0x0040
- #define LLC_INDICATE_ACCESS_PRTY_LOWERED 0x0020
- #define LLC_INDICATE_LOCAL_STATION_BUSY 0x0001
- 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 uchAccessPritority;
- UCHAR uchRemoteNodeAddress[6];
- UCHAR uchRemoteSap;
- UCHAR uchReserved;
- USHORT usUserStatusValue;
- } Status;
- } Type;
- } LLC_READ_PARMS, *PLLC_READ_PARMS;
- //
- // This data structure gives the best performance in Windows/Nt: The DLC driver
- // must copy the CCB and the parameter table. If the driver knows that the
- // parameter table is concatenated to the CCB, it can copy both structures at
- // once. NOTE: The pointer to the parameter table MUST still be present in the
- // CCB
- //
- typedef struct {
- LLC_CCB Ccb;
- LLC_READ_PARMS Parms;
- } LLC_READ_COMMAND, *PLLC_READ_COMMAND;
- //
- // New receive types for direct stations, these types are ignored if the direct
- // station was opened with a specific ethernet type
- //
- #define LLC_DIR_RCV_ALL_TR_FRAMES 0
- #define LLC_DIR_RCV_ALL_MAC_FRAMES 1
- #define LLC_DIR_RCV_ALL_8022_FRAMES 2
- #define LLC_DIR_RCV_ALL_FRAMES 4
- #define LLC_DIR_RCV_ALL_ETHERNET_TYPES 5
- #define LLC_CONTIGUOUS_MAC 0x80
- #define LLC_CONTIGUOUS_DATA 0x40
- #define LLC_NOT_CONTIGUOUS_DATA 0x00
- //
- // LLC_BREAK (0x20) is not supported by Windows/Nt
- //
- #define LLC_RCV_READ_INDIVIDUAL_FRAMES 0
- #define LLC_RCV_CHAIN_FRAMES_ON_LINK 1
- #define LLC_RCV_CHAIN_FRAMES_ON_SAP 2
- typedef struct {
- USHORT usStationId; // SAP, link station or direct id
- USHORT usUserLength; // length of user data in buffer header
- ULONG ulReceiveFlag; // the received data handler
- PLLC_BUFFER pFirstBuffer; // first buffer in the pool
- UCHAR uchOptions; // defines how the frame is received
- UCHAR auchReserved1[3];
- UCHAR uchRcvReadOption; // defines if rcv frames are chained
- } LLC_RECEIVE_PARMS, *PLLC_RECEIVE_PARMS;
- #define LLC_CHAIN_XMIT_COMMANDS_ON_LINK 0
- #define LLC_COMPLETE_SINGLE_XMIT_FRAME 1
- #define LLC_CHAIN_XMIT_COMMANDS_ON_SAP 2
- typedef struct {
- USHORT usStationId; // SAP, link station or direct id
- UCHAR uchTransmitFs; // token-ring frame status
- UCHAR uchRemoteSap; // remote destination SAP
- PLLC_XMIT_BUFFER pXmitQueue1; // first link list of frame segments
- PLLC_XMIT_BUFFER pXmitQueue2; // another segment list returuned to pool
- USHORT cbBuffer1; // length of buffer 1
- USHORT cbBuffer2; // length of buffer 2
- PVOID pBuffer1; // yet another segment
- PVOID pBuffer2; // this is the last segment of frame
- UCHAR uchXmitReadOption; // defines completion event for READ
- } LLC_TRANSMIT_PARMS, *PLLC_TRANSMIT_PARMS;
- #define LLC_FIRST_DATA_SEGMENT 0x01
- #define LLC_NEXT_DATA_SEGMENT 0x02
- typedef struct {
- UCHAR eSegmentType; // defines if first or next segment of frame
- UCHAR boolFreeBuffer; // if set, this buffer is released to pool
- USHORT cbBuffer; // length of this buffer
- PVOID pBuffer;
- } LLC_TRANSMIT_DESCRIPTOR, *PLLC_TRANSMIT_DESCRIPTOR;
- //
- // The frames types returned in the first receive buffer or used with the
- // TRANSMIT_FRAMES command. A direct station may also send only ethernet
- // frames. The ethernet types are only for transmit. Types 0x0019 - 0x05DC
- // are reserved
- //
- enum _LLC_FRAME_TYPES { // Purpose:
- LLC_DIRECT_TRANSMIT = 0x0000, // transmit
- LLC_DIRECT_MAC = 0x0002, // receive
- LLC_I_FRAME = 0x0004, // receive & transmit
- LLC_UI_FRAME = 0x0006, // receive & transmit
- LLC_XID_COMMAND_POLL = 0x0008, // receive & transmit
- LLC_XID_COMMAND_NOT_POLL = 0x000A, // receive & transmit
- LLC_XID_RESPONSE_FINAL = 0x000C, // receive & transmit
- LLC_XID_RESPONSE_NOT_FINAL = 0x000E, // receive & transmit
- LLC_TEST_RESPONSE_FINAL = 0x0010, // receive & transmit
- LLC_TEST_RESPONSE_NOT_FINAL = 0x0012, // receive & transmit
- LLC_DIRECT_8022 = 0x0014, // receive (direct station)
- LLC_TEST_COMMAND_POLL = 0x0016, // transmit
- LLC_DIRECT_ETHERNET_TYPE = 0x0018, // receive (direct station)
- LLC_LAST_FRAME_TYPE = 0x001a, // reserved
- LLC_FIRST_ETHERNET_TYPE = 0x05DD // transmit (>)
- };
- typedef struct {
- LLC_CCB Ccb; // use this as transmit CCB
- USHORT usStationId;
- USHORT usFrameType; // DLC frame or ethernet type
- UCHAR uchRemoteSap; // used with UI, TEST, XID frames
- UCHAR uchXmitReadOption;
- UCHAR Reserved2[2];
- ULONG cXmitBufferCount;
- LLC_TRANSMIT_DESCRIPTOR aXmitBuffer[1];
- } LLC_TRANSMIT2_COMMAND, *PLLC_TRANSMIT2_COMMAND;
- //
- // LLC_TRANSMIT2_VAR_PARMS - this macro allocates space for variable length
- // descriptor array, eg: LLC_TRANSMIT2_VAR_PARMS(8) TransmitParms;
- //
- #define LLC_TRANSMIT2_VAR_PARMS(a)
- struct {
- LLC_CCB Ccb;
- USHORT usStationId;
- USHORT usFrameType;
- UCHAR uchRemoteSap;
- UCHAR uchXmitReadOption;
- UCHAR uchReserved2[2];
- ULONG cXmitBufferCount;
- LLC_TRANSMIT_DESCRIPTOR XmitBuffer[(a)];
- }
- //
- // LLC_PARMS - All CCB parameter tables can be referred to using this union
- //
- union _LLC_PARMS {
- LLC_BUFFER_FREE_PARMS BufferFree;
- LLC_BUFFER_GET_PARMS BufferGet;
- LLC_DLC_CONNECT_PARMS DlcConnectStation;
- LLC_DLC_MODIFY_PARMS DlcModify;
- LLC_DLC_OPEN_SAP_PARMS DlcOpenSap;
- LLC_DLC_OPEN_STATION_PARMS DlcOpenStation;
- LLC_DLC_REALLOCATE_PARMS DlcReallocate;
- LLC_DLC_SET_THRESHOLD_PARMS DlcSetThreshold;
- LLC_DLC_STATISTICS_PARMS DlcStatistics;
- LLC_DIR_INITIALIZE_PARMS DirInitialize;
- LLC_DIR_OPEN_ADAPTER_PARMS DirOpenAdapter;
- LLC_DIR_OPEN_DIRECT_PARMS DirOpenDirect;
- LLC_DIR_READ_LOG_PARMS DirReadLog;
- LLC_DIR_SET_EFLAG_PARMS DirSetEventFlag;
- LLC_DIR_STATUS_PARMS DirStatus;
- LLC_READ_PARMS Read;
- LLC_RECEIVE_PARMS Receive;
- LLC_TRANSMIT_PARMS Transmit;
- LLC_TRANSMIT2_COMMAND Transmit2;
- LLC_TRACE_INITIALIZE_PARMS TraceInitialize;
- };
- //
- // LLC_STATUS - enumerates the return codes which appear in the CCB uchDlcStatus
- // field
- //
- typedef enum _LLC_STATUS {
- LLC_STATUS_SUCCESS = 0x00,
- LLC_STATUS_INVALID_COMMAND = 0x01,
- LLC_STATUS_DUPLICATE_COMMAND = 0x02,
- LLC_STATUS_ADAPTER_OPEN = 0x03,
- LLC_STATUS_ADAPTER_CLOSED = 0x04,
- LLC_STATUS_PARAMETER_MISSING = 0x05,
- LLC_STATUS_INVALID_OPTION = 0x06,
- LLC_STATUS_COMMAND_CANCELLED_FAILURE = 0x07,
- LLC_STATUS_ACCESS_DENIED = 0x08, // not used in Windows/Nt
- LLC_STATUS_ADAPTER_NOT_INITIALIZED = 0x09, // not used in Windows/Nt
- LLC_STATUS_CANCELLED_BY_USER = 0x0A,
- LLC_STATUS_COMMAND_CANCELLED_CLOSED = 0x0B, // not used in Windows/Nt
- LLC_STATUS_SUCCESS_NOT_OPEN = 0x0C,
- LLC_STATUS_TIMER_ERROR = 0x11,
- LLC_STATUS_NO_MEMORY = 0x12,
- LLC_STATUS_INVALID_LOG_ID = 0x13, // not used in Windows/Nt
- LLC_STATUS_LOST_LOG_DATA = 0x15,
- LLC_STATUS_BUFFER_SIZE_EXCEEDED = 0x16,
- LLC_STATUS_INVALID_BUFFER_LENGTH = 0x18,
- LLC_STATUS_INADEQUATE_BUFFERS = 0x19,
- LLC_STATUS_USER_LENGTH_TOO_LARGE = 0x1A,
- LLC_STATUS_INVALID_PARAMETER_TABLE = 0x1B,
- LLC_STATUS_INVALID_POINTER_IN_CCB = 0x1C,
- LLC_STATUS_INVALID_ADAPTER = 0x1D,
- LLC_STATUS_LOST_DATA_NO_BUFFERS = 0x20,
- LLC_STATUS_LOST_DATA_INADEQUATE_SPACE = 0x21,
- LLC_STATUS_TRANSMIT_ERROR_FS = 0x22,
- LLC_STATUS_TRANSMIT_ERROR = 0x23,
- LLC_STATUS_UNAUTHORIZED_MAC = 0x24, // not used in Windows/Nt
- LLC_STATUS_MAX_COMMANDS_EXCEEDED = 0x25, // not used in Windows/Nt
- LLC_STATUS_LINK_NOT_TRANSMITTING = 0x27,
- LLC_STATUS_INVALID_FRAME_LENGTH = 0x28,
- LLC_STATUS_INADEQUATE_RECEIVE = 0x30, // not used in Windows/Nt
- LLC_STATUS_INVALID_NODE_ADDRESS = 0x32,
- LLC_STATUS_INVALID_RCV_BUFFER_LENGTH = 0x33,
- LLC_STATUS_INVALID_XMIT_BUFFER_LENGTH = 0x34,
- LLC_STATUS_INVALID_STATION_ID = 0x40,
- LLC_STATUS_LINK_PROTOCOL_ERROR = 0x41,
- LLC_STATUS_PARMETERS_EXCEEDED_MAX = 0x42,
- LLC_STATUS_INVALID_SAP_VALUE = 0x43,
- LLC_STATUS_INVALID_ROUTING_INFO = 0x44,
- LLC_STATUS_RESOURCES_NOT_AVAILABLE = 0x46, // not used in Windows/Nt
- LLC_STATUS_LINK_STATIONS_OPEN = 0x47,
- LLC_STATUS_INCOMPATIBLE_COMMANDS = 0x4A,
- LLC_STATUS_OUTSTANDING_COMMANDS = 0x4C, // not used in Windows/Nt
- LLC_STATUS_CONNECT_FAILED = 0x4D,
- LLC_STATUS_INVALID_REMOTE_ADDRESS = 0x4F,
- LLC_STATUS_CCB_POINTER_FIELD = 0x50,
- LLC_STATUS_INVALID_APPLICATION_ID = 0x52, // not used in Windows/Nt
- LLC_STATUS_NO_SYSTEM_PROCESS = 0x56, // not used in Windows/Nt
- LLC_STATUS_INADEQUATE_LINKS = 0x57,
- LLC_STATUS_INVALID_PARAMETER_1 = 0x58,
- LLC_STATUS_DIRECT_STATIONS_NOT_ASSIGNED = 0x5C,
- LLC_STATUS_DEVICE_DRIVER_NOT_INSTALLED = 0x5d,
- LLC_STATUS_ADAPTER_NOT_INSTALLED = 0x5e,
- LLC_STATUS_CHAINED_DIFFERENT_ADAPTERS = 0x5f,
- LLC_STATUS_INIT_COMMAND_STARTED = 0x60,
- LLC_STATUS_TOO_MANY_USERS = 0x61, // not used in Windows/Nt
- LLC_STATUS_CANCELLED_BY_SYSTEM_ACTION = 0x62,
- LLC_STATUS_DIR_STATIONS_NOT_AVAILABLE = 0x63, // not used in Windows/Nt
- LLC_STATUS_NO_GDT_SELECTORS = 0x65,
- LLC_STATUS_MEMORY_LOCK_FAILED = 0x69,
- //
- // New NT DLC specific error codes begin from 0x80
- // These error codes are for new Windows/Nt DLC apps.
- //
- LLC_STATUS_INVALID_BUFFER_ADDRESS = 0x80,
- LLC_STATUS_BUFFER_ALREADY_RELEASED = 0x81,
- LLC_STATUS_BIND_ERROR = 0xA0, // not used in Windows/Nt
- LLC_STATUS_INVALID_VERSION = 0xA1,
- LLC_STATUS_NT_ERROR_STATUS = 0xA2,
- LLC_STATUS_PENDING = 0xFF
- } LLC_STATUS;
- #define LLC_STATUS_MAX_ERROR 0xFF
- //
- // ACSLAN_STATUS - status codes which are returned from AcsLan
- //
- typedef enum {
- ACSLAN_STATUS_COMMAND_ACCEPTED = 0,
- ACSLAN_STATUS_INVALID_CCB_POINTER = 1,
- ACSLAN_STATUS_CCB_IN_ERROR = 2,
- ACSLAN_STATUS_CHAINED_CCB_IN_ERROR = 3,
- ACSLAN_STATUS_SYSTEM_ERROR = 4,
- ACSLAN_STATUS_SYSTEM_STATUS = 5,
- ACSLAN_STATUS_INVALID_COMMAND = 6
- } ACSLAN_STATUS;
- //
- // prototypes
- //
- ACSLAN_STATUS
- APIENTRY
- AcsLan(
- IN OUT PLLC_CCB pCcb,
- OUT PLLC_CCB* ppBadCcb
- );
- LLC_STATUS
- APIENTRY
- GetAdapterNameFromNumber(
- IN UINT AdapterNumber,
- OUT LPTSTR pNdisName
- );
- LLC_STATUS
- APIENTRY
- GetAdapterNumberFromName(
- IN LPTSTR pNdisName,
- OUT UINT *AdapterNumber
- );
- #ifdef __cplusplus
- }
- #endif
- #endif // _DLCAPI_