You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3991 lines
121 KiB
3991 lines
121 KiB
/*++
|
|
|
|
Copyright (c) 1991 Microsoft Corporation
|
|
Copyright (c) 1991 Nokia Data Systems
|
|
|
|
Module Name:
|
|
|
|
vrdlcpst.c
|
|
|
|
Abstract:
|
|
|
|
This module implements the call-back functions for DOS DLC CCBs. The call-
|
|
backs are also referred to (in IBM terminology) as appendages or exits.
|
|
These are executed asynchronously when a CCB request completes. Other
|
|
asynchronous events can be generated such as adapter status change or
|
|
network error. These latter types (& other similar events) are dependent
|
|
upon the adapter hardware we are using - Token Ring or EtherNet (IBM Ether
|
|
Link or PC Network), and are not expected to occur frequently (usually in
|
|
error situations or where something bad happens to the net).
|
|
|
|
We maintain a READ CCB for each supported adapter (2 per VDM). The READ
|
|
will capture ALL events - command completions, data reception, status
|
|
change, etc. When a READ CCB completes, we put it in a queue of completed
|
|
CCBs and interrupt the VDM. The VDM must asynchronously call back to
|
|
VrDlcHwInterrupt where it dequeues and processes the completed command at
|
|
the head of the queue. The READ CCB has a pointer to the completed CCB or
|
|
received data. If the READ is for a completed NT CCB then the CCB will have
|
|
a pointer to the original DOS CCB. We have to get the original DOS CCB
|
|
address from the NT CCB and complete the command with the relevant
|
|
information contained in the READ/completed NT CCBs.
|
|
|
|
We never expect the queue of pending completions/data receptions to grow
|
|
very large, since DOS is single-tasking and unless it has interrupts
|
|
disabled for a large part of the time, then the completion queue should be
|
|
processed in a timely fashion
|
|
|
|
Contents:
|
|
VrDlcInitialize
|
|
VrDlcHwInterrupt
|
|
(FindCompletedRead)
|
|
(ProcessReceiveFrame)
|
|
(QueryEmulatedLocalBusyState)
|
|
(SetEmulatedLocalBusyState)
|
|
ResetEmulatedLocalBusyState
|
|
(ResetEmulatedLocalBusyStateSap)
|
|
(ResetEmulatedLocalBusyStateLink)
|
|
(DeferReceive)
|
|
(DeferAllIFrames)
|
|
(RemoveDeferredReceive)
|
|
(VrDlcEventHandlerThread)
|
|
InitializeEventHandler
|
|
InitiateRead
|
|
(PutEvent)
|
|
(PeekEvent)
|
|
(GetEvent)
|
|
(FlushEventQueue)
|
|
(RemoveDeadReceives)
|
|
(ReleaseReceiveResources)
|
|
(IssueHardwareInterrupt)
|
|
(AcknowledgeHardwareInterrupt)
|
|
(CancelHardwareInterrupts)
|
|
|
|
Author:
|
|
|
|
Antti Saarenheimo (o-anttis) 26-DEC-1991
|
|
|
|
Revision History:
|
|
|
|
16-Jul-1992 rfirth
|
|
Added queue and interrupt serialization; debugging
|
|
|
|
19-Nov-1992 rfirth
|
|
substantially modified event processing - use a queue per adapter;
|
|
consolidated per-adapter data into DOS_ADAPTER structure; re-wrote
|
|
local-busy processing
|
|
|
|
Note: It turns out that a thread can recursively enter a critical
|
|
section. The functions marked 'MUST [NOT] BE ENTERED WHILE HOLDING
|
|
CRITICAL SECTION <foo>' could be altered
|
|
|
|
--*/
|
|
|
|
#include <nt.h>
|
|
#include <ntrtl.h> // ASSERT, DbgPrint
|
|
#include <nturtl.h>
|
|
#include <windows.h>
|
|
#include <softpc.h> // x86 virtual machine definitions
|
|
#include <vrdlctab.h>
|
|
#include <vdmredir.h>
|
|
#include "vrdebug.h"
|
|
#include <dlcapi.h> // Official DLC API definition
|
|
#include <ntdddlc.h> // IOCTL commands
|
|
#include <dlcio.h> // Internal IOCTL API interface structures
|
|
#include "vrdlc.h"
|
|
#include "vrdlcdbg.h"
|
|
#define BOOL
|
|
#include <insignia.h> // Insignia defines
|
|
#include <xt.h> // half_word
|
|
#include <ica.h> // ica_hw_interrupt
|
|
#include <vrica.h> // call_ica_hw_interrupt
|
|
|
|
//
|
|
// defines
|
|
//
|
|
|
|
#define EVENT_THREAD_STACK 0 // 4096
|
|
|
|
//
|
|
// macros
|
|
//
|
|
|
|
//
|
|
// IS_LOCAL_BUSY - determines whether we have a LOCAL BUSY state active for a
|
|
// particular link station
|
|
//
|
|
|
|
#define IS_LOCAL_BUSY(adapter, stationId) (QueryEmulatedLocalBusyState((BYTE)adapter, (WORD)stationId) == BUSY)
|
|
|
|
//
|
|
// private types
|
|
//
|
|
|
|
typedef enum {
|
|
INDICATE_RECEIVE_FRAME,
|
|
INDICATE_LOCAL_BUSY,
|
|
INDICATE_COMPLETE_RECEIVE
|
|
} INDICATION;
|
|
|
|
typedef enum {
|
|
CURRENT,
|
|
DEFERRED
|
|
} READ_FRAME_TYPE;
|
|
|
|
//
|
|
// private prototypes
|
|
//
|
|
|
|
PLLC_CCB
|
|
FindCompletedRead(
|
|
OUT READ_FRAME_TYPE* pFrameType
|
|
);
|
|
|
|
INDICATION
|
|
ProcessReceiveFrame(
|
|
IN OUT PLLC_CCB* ppCcb,
|
|
IN LLC_DOS_CCB UNALIGNED * pDosCcb,
|
|
IN LLC_DOS_PARMS UNALIGNED * pDosParms,
|
|
OUT LLC_STATUS* Status
|
|
);
|
|
|
|
LOCAL_BUSY_STATE
|
|
QueryEmulatedLocalBusyState(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
);
|
|
|
|
VOID
|
|
SetEmulatedLocalBusyState(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
);
|
|
|
|
BOOLEAN
|
|
ResetEmulatedLocalBusyStateSap(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN BYTE DlcCommand
|
|
);
|
|
|
|
BOOLEAN
|
|
ResetEmulatedLocalBusyStateLink(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN BYTE DlcCommand
|
|
);
|
|
|
|
VOID
|
|
DeferReceive(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN PLLC_CCB pReadCcb
|
|
);
|
|
|
|
VOID
|
|
DeferAllIFrames(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
);
|
|
|
|
PLLC_CCB
|
|
RemoveDeferredReceive(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
OUT BOOLEAN* pDeferredFramesLeft
|
|
);
|
|
|
|
DWORD
|
|
VrDlcEventHandlerThread(
|
|
IN PVOID pParameter
|
|
);
|
|
|
|
VOID
|
|
PutEvent(
|
|
IN BYTE AdapterNumber,
|
|
IN PLLC_CCB pCcb
|
|
);
|
|
|
|
PLLC_CCB
|
|
PeekEvent(
|
|
IN BYTE AdapterNumber
|
|
);
|
|
|
|
PLLC_CCB
|
|
GetEvent(
|
|
IN BYTE AdapterNumber
|
|
);
|
|
|
|
VOID
|
|
FlushEventQueue(
|
|
IN BYTE AdapterNumber
|
|
);
|
|
|
|
VOID
|
|
RemoveDeadReceives(
|
|
IN PLLC_CCB pCcb
|
|
);
|
|
|
|
VOID
|
|
ReleaseReceiveResources(
|
|
IN PLLC_CCB pCcb
|
|
);
|
|
|
|
VOID
|
|
IssueHardwareInterrupt(
|
|
VOID
|
|
);
|
|
|
|
VOID
|
|
AcknowledgeHardwareInterrupt(
|
|
VOID
|
|
);
|
|
|
|
VOID
|
|
CancelHardwareInterrupts(
|
|
IN LONG Count
|
|
);
|
|
|
|
//
|
|
// external functions
|
|
//
|
|
|
|
extern ACSLAN_STATUS (*lpAcsLan)(IN OUT PLLC_CCB, OUT PLLC_CCB*);
|
|
|
|
extern
|
|
VOID
|
|
VrQueueCompletionHandler(
|
|
IN VOID (*AsyncDispositionRoutine)(VOID)
|
|
);
|
|
|
|
extern
|
|
VOID
|
|
VrRaiseInterrupt(
|
|
VOID
|
|
);
|
|
|
|
//
|
|
// external data
|
|
//
|
|
|
|
extern DOS_ADAPTER Adapters[DOS_DLC_MAX_ADAPTERS];
|
|
|
|
//
|
|
// private data
|
|
//
|
|
|
|
//
|
|
// aReadCcbs - for each adapter (max. 2) we have an NT READ CCB which is used
|
|
// to get received data which is returned to the DOS program via its RECEIVE
|
|
// CCB. Note that these are pointers to CCBs, not the actual CCBs. We also get
|
|
// status changes & command completions through the same mechanism. These are
|
|
// reflected to the VDM through the various 'appendages'
|
|
//
|
|
// NB: once initialized, this array is ONLY WRITTEN BY InitiateRead
|
|
//
|
|
|
|
PLLC_CCB aReadCcbs[DOS_DLC_MAX_ADAPTERS];
|
|
|
|
//
|
|
// aReadEvents - for each adapter (max. 2) we have a handle to an EVENT object.
|
|
// This is in the unsignalled state until an event completes the READ CCB.
|
|
// These are kept in an array because this is how WaitForMultipleObjects
|
|
// expects them
|
|
//
|
|
|
|
HANDLE aReadEvents[DOS_DLC_MAX_ADAPTERS];
|
|
|
|
//
|
|
// HardwareIntCritSec is used to protect updates to HardwareIntsQueued.
|
|
// HardwareIntsQueued is the number of outstanding hardware interrupt requests
|
|
// to the VDM. -1 means none outstanding, 0 is 1, etc.
|
|
//
|
|
|
|
#define NO_INTERRUPTS_PENDING (-1)
|
|
|
|
static CRITICAL_SECTION HardwareIntCritSec;
|
|
static LONG HardwareIntsQueued = NO_INTERRUPTS_PENDING;
|
|
|
|
//
|
|
// hEventThread - handle of asynchronous event thread
|
|
//
|
|
|
|
static HANDLE hEventThread;
|
|
|
|
|
|
//
|
|
// routines
|
|
//
|
|
|
|
VOID
|
|
VrDlcInitialize(
|
|
VOID
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Initializes critical sections that must always be available
|
|
|
|
Arguments:
|
|
|
|
None.
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
IF_DEBUG(DLC) {
|
|
DPUT("VrDlcInitialize\n");
|
|
}
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("VrDlcInitialize\n"));
|
|
}
|
|
|
|
//
|
|
// initialize the critical section for the event list
|
|
//
|
|
|
|
InitializeCriticalSection(&HardwareIntCritSec);
|
|
}
|
|
|
|
|
|
BOOLEAN
|
|
VrDlcHwInterrupt(
|
|
VOID
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Procedure reads one DOS appendage call from the event queue
|
|
and sets the initializes MS-DOS registers for the appendage
|
|
call. A NT DLC event may generate several DOS appendage calls.
|
|
It is also possible, that no appendage call is needed.
|
|
The event queue is incremented only after the last DOS appendage
|
|
has been generated
|
|
|
|
Return Value:
|
|
|
|
FALSE - the event queue was empty, poll the next interrupt handler
|
|
TRUE - an event was handled successfully.
|
|
|
|
--*/
|
|
|
|
{
|
|
BOOLEAN GetNewEvent = FALSE; // default no extra events generated
|
|
PLLC_CCB pReadCcb; // READ CCB at head of EventQueue
|
|
PLLC_READ_PARMS pReadParms; // READ parameter table
|
|
LLC_DOS_CCB UNALIGNED * pDosCcb;// flat 32-bit pointer to DOS CCB
|
|
WORD cLeft;
|
|
PLLC_CCB pCcb;
|
|
LLC_CCB UNALIGNED * pFlatCcbAddr;
|
|
LLC_DOS_PARMS UNALIGNED * pParms;
|
|
DWORD iStation;
|
|
static DWORD iCurrentTempStatus = 0;
|
|
PLLC_BUFFER pNtFrame; // pointer to received NT frame
|
|
PLLC_DOS_RECEIVE_PARMS_EX pRcvParms; // special NT rcv params for DOS
|
|
LLC_STATUS Status;
|
|
INDICATION indication;
|
|
WORD buffersLeft;
|
|
DOS_ADDRESS dpDosCcb;
|
|
DOS_ADDRESS newAddress;
|
|
READ_FRAME_TYPE frameType;
|
|
BYTE adapterNumber;
|
|
BYTE sapNumber;
|
|
WORD stationId = 0;
|
|
PLLC_CCB cancelledReceive = NULL;
|
|
|
|
#if DBG
|
|
|
|
CHAR reasonCode;
|
|
DWORD reasonCount;
|
|
|
|
#endif
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcHwInterrupt entered\n");
|
|
}
|
|
|
|
//
|
|
// preset the VDM flags to do nothing by default when control is returned
|
|
// to the hardware interrupt service routine
|
|
//
|
|
|
|
SET_CALLBACK_NOTHING();
|
|
|
|
//
|
|
// This is called from the hardware interrupt handler in vrnetb.c. If there
|
|
// are no events in the queue, then let the NetBIOS h/w interrupt handler
|
|
// check if it has any completed NCBs. If there is something in the DLC
|
|
// event queue then we will return info to the DOS box telling it that it
|
|
// has a completed CCB; if there was something to complete for NetBIOS,
|
|
// then it will have to wait until all pending DLC events are completed
|
|
//
|
|
|
|
pReadCcb = FindCompletedRead(&frameType);
|
|
if (pReadCcb == NULL) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("*** VrDlcHwInterrupt: Error: no completed READs ***\n");
|
|
}
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** VrDlcHwInterrupt: Error: no completed READs ***\n"));
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** VrDlcHwInterrupt: READ CCB Peeked @ %x ***\n", pReadCcb));
|
|
}
|
|
|
|
//
|
|
// get the completion event and dispatch it
|
|
//
|
|
|
|
pReadParms = &pReadCcb->u.pParameterTable->Read;
|
|
adapterNumber = pReadCcb->uchAdapterNumber;
|
|
switch (pReadParms->uchEvent) {
|
|
case LLC_EVENT_COMMAND_COMPLETION:
|
|
|
|
//
|
|
// Event 0x01
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcHwInterrupt: LLC_EVENT_COMMAND_COMPLETION\n");
|
|
}
|
|
|
|
//
|
|
// Complete only the first CCB command in the list.
|
|
// The completed receive CCBs are in the 32-bit flat address
|
|
// space (we cannot pass them through to DOS because of
|
|
// different buffer format between DOS and Nt (or OS/2)).
|
|
//
|
|
// Every completed receive command (the ones with receive data flag
|
|
// are never completed here) uses LLC_DOS_SPECIAL_COMMAND as its
|
|
// input flag, the command actual post routine address and the
|
|
// original CCB address in DOS have been save to its parameter table.
|
|
// The completion flag is zero, if the receive command is not
|
|
// completed by a command completion routine.
|
|
//
|
|
|
|
pCcb = pReadParms->Type.Event.pCcbCompletionList;
|
|
|
|
if (pReadParms->ulNotificationFlag == LLC_DOS_SPECIAL_COMMAND) {
|
|
|
|
//
|
|
// The DOS receive is yet another exception:
|
|
// We cannot directly use the DOS receive CCB, because
|
|
// the driver completes the command with the received data in
|
|
// NT buffers => we have allocated a special receive CCB and
|
|
// parameter table from 32-bit address space to execute
|
|
// the same receive command. We must now copy the received data
|
|
// back to DOS buffer pools and then complete the original DOS
|
|
// receive CCB
|
|
//
|
|
|
|
pRcvParms = (PVOID)READ_DWORD(&pCcb->u.pParameterTable);
|
|
pDosCcb = DOS_PTR_TO_FLAT((PVOID)READ_DWORD(&pRcvParms->dpOriginalCcbAddress));
|
|
|
|
//
|
|
// Copy the received data only if the receive was successful
|
|
//
|
|
|
|
if (pCcb->uchDlcStatus == STATUS_SUCCESS ||
|
|
pCcb->uchDlcStatus == LLC_STATUS_LOST_DATA_INADEQUATE_SPACE) {
|
|
|
|
//
|
|
// We must complete here all receive data commands regardless
|
|
// if they have a DOS appendage. Zero value in appendage
|
|
// means, that we don't call appendage routine.
|
|
// (interrupt vectors don't usually include executable code).
|
|
//
|
|
|
|
if (pRcvParms->dpCompletionFlag != 0) {
|
|
setPostRoutine(pRcvParms->dpCompletionFlag);
|
|
setES(HIWORD(pRcvParms->dpOriginalCcbAddress));
|
|
setBX(LOWORD(pRcvParms->dpOriginalCcbAddress));
|
|
setAX((WORD)pCcb->uchDlcStatus);
|
|
}
|
|
} else {
|
|
setPostRoutine(0);
|
|
}
|
|
pDosCcb->uchDlcStatus = pCcb->uchDlcStatus;
|
|
cancelledReceive = pCcb;
|
|
|
|
} else {
|
|
|
|
//
|
|
// On entry to the command completion appendage, the following
|
|
// are set:
|
|
//
|
|
// ES:BX = CCB address of the completed command.
|
|
// CX = adapter number
|
|
// AL = return code from CCB_RETCODE
|
|
// AH = 0x00
|
|
//
|
|
|
|
pFlatCcbAddr = DOS_PTR_TO_FLAT(pCcb);
|
|
setES(HIWORD(pCcb));
|
|
setBX(LOWORD(pCcb));
|
|
setCX((WORD)pFlatCcbAddr->uchAdapterNumber);
|
|
setAX((WORD)pFlatCcbAddr->uchDlcStatus);
|
|
setPostRoutine(pReadParms->ulNotificationFlag);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("COMMAND_COMPLETION: ANR=%04x:%04x CCB=%04x:%04x Type=%02x Status=%02x Adapter=%04x\n",
|
|
HIWORD(pReadParms->ulNotificationFlag),
|
|
LOWORD(pReadParms->ulNotificationFlag),
|
|
getES(),
|
|
getBX(),
|
|
pFlatCcbAddr->uchDlcCommand,
|
|
getAL(),
|
|
getCX()
|
|
));
|
|
}
|
|
}
|
|
break;
|
|
|
|
case LLC_EVENT_TRANSMIT_COMPLETION:
|
|
|
|
//
|
|
// Event 0x02
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcHwInterrupt: LLC_EVENT_TRANSMIT_COMPLETION\n");
|
|
}
|
|
|
|
//
|
|
// Map first CCB pointer and its parameter table to 32-bit addr space
|
|
//
|
|
|
|
pCcb = pReadParms->Type.Event.pCcbCompletionList;
|
|
pFlatCcbAddr = (PLLC_CCB)DOS_PTR_TO_FLAT(pCcb);
|
|
pParms = (PLLC_DOS_PARMS)DOS_PTR_TO_FLAT(READ_DWORD(&pFlatCcbAddr->u.pParameterTable));
|
|
|
|
IF_DEBUG(TX_COMPLETE) {
|
|
DPUT3("VrDlcHwInterrupt: pCcb=%x pFlatCcbAddr=%x pParms=%x\n",
|
|
pCcb,
|
|
pFlatCcbAddr,
|
|
pParms
|
|
);
|
|
}
|
|
|
|
//
|
|
// there may be several completed transmit CCBs chained together
|
|
//
|
|
|
|
if (--pReadParms->Type.Event.usCcbCount) {
|
|
|
|
//
|
|
// RLF 09/24/92
|
|
//
|
|
// If there are multiple completions linked together then we leave
|
|
// this READ CCB at the head of the queue. Decrement the number of
|
|
// CCBs left and update the pointer to the next one
|
|
//
|
|
|
|
pReadParms->Type.Event.pCcbCompletionList = (PLLC_CCB)READ_DWORD(&pFlatCcbAddr->pNext);
|
|
WRITE_DWORD(&pFlatCcbAddr->pNext, 0);
|
|
pReadCcb = NULL;
|
|
GetNewEvent = TRUE;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("VrDlcHwInterrupt: next Tx completion: %04x:%04x\n",
|
|
HIWORD(pReadParms->Type.Event.pCcbCompletionList),
|
|
LOWORD(pReadParms->Type.Event.pCcbCompletionList)
|
|
);
|
|
}
|
|
|
|
#if DBG
|
|
|
|
reasonCode = 'T';
|
|
reasonCount = pReadParms->Type.Event.usCcbCount;
|
|
|
|
#endif
|
|
|
|
}
|
|
|
|
//
|
|
// The second transmit queue must be returned to the buffer pool IF the
|
|
// transmit was successful
|
|
//
|
|
|
|
if (pFlatCcbAddr->uchDlcStatus == LLC_STATUS_SUCCESS && READ_DWORD(&pParms->Transmit.pXmitQueue2)) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("VrDlcHwInterrupt: freeing XmitQueue2 @ %04x:%04x\n",
|
|
GET_SEGMENT(&pParms->Transmit.pXmitQueue2),
|
|
GET_OFFSET(&pParms->Transmit.pXmitQueue2)
|
|
);
|
|
}
|
|
|
|
//
|
|
// p2-47 IBM LAN Tech Ref:
|
|
//
|
|
// "Buffers in XMIT_QUEUE_TWO are freed by the adapter support
|
|
// software if the transmission is successful (return code is
|
|
// zero)."
|
|
//
|
|
|
|
FreeBuffers(GET_POOL_INDEX(pFlatCcbAddr->uchAdapterNumber,
|
|
READ_WORD(&pParms->Transmit.usStationId)
|
|
),
|
|
(DPLLC_DOS_BUFFER)READ_DWORD(&pParms->Transmit.pXmitQueue2),
|
|
&cLeft
|
|
);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcHwInterrupt: after FreeBuffers: %d buffers left\n", cLeft);
|
|
// DUMPCCB(pFlatCcbAddr,
|
|
// TRUE, // DumpAll
|
|
// FALSE, // CcbIsInput
|
|
// TRUE, // IsDos
|
|
// HIWORD(pCcb), // Segment
|
|
// LOWORD(pCcb) // Offset
|
|
// );
|
|
}
|
|
|
|
//
|
|
// p3-105 IBM LAN Tech Ref:
|
|
//
|
|
// "Before taking an appendage exit or posting completion, the
|
|
// buffers in this queue are returned to the SAP buffer pool
|
|
// and this field set to zero upon command completion if the
|
|
// return code equals zero (X'00)."
|
|
//
|
|
|
|
WRITE_DWORD(&pParms->Transmit.pXmitQueue2, 0);
|
|
}
|
|
|
|
//
|
|
// this is a real asynchronous notification - we must asynchronously
|
|
// call a DOS appendage routine - set up registers:
|
|
//
|
|
// ES:BX = completed (transmit) CCB
|
|
// CX = adapter number
|
|
// AL = return status
|
|
// AH = 0x00
|
|
//
|
|
|
|
setPostRoutine(pReadParms->ulNotificationFlag);
|
|
setES(HIWORD(pCcb));
|
|
setBX(LOWORD(pCcb));
|
|
setCX((WORD)pFlatCcbAddr->uchAdapterNumber);
|
|
setAX((WORD)pFlatCcbAddr->uchDlcStatus);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("TRANSMIT_COMPLETION: ANR=%04x:%04x CCB=%04x:%04x Type=%02x Status=%02x Adapter=%04x\n",
|
|
HIWORD(pReadParms->ulNotificationFlag),
|
|
LOWORD(pReadParms->ulNotificationFlag),
|
|
getES(),
|
|
getBX(),
|
|
pFlatCcbAddr->uchDlcCommand,
|
|
getAL(),
|
|
getCX()
|
|
));
|
|
}
|
|
|
|
break;
|
|
|
|
case LLC_EVENT_RECEIVE_DATA:
|
|
|
|
//
|
|
// Event 0x04
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcHwInterrupt: LLC_EVENT_RECEIVE_DATA\n");
|
|
|
|
//
|
|
// dump the NT extended RECEIVE + parms
|
|
//
|
|
|
|
DUMPCCB((PLLC_CCB)(pReadParms->ulNotificationFlag),
|
|
TRUE, // DumpAll
|
|
FALSE, // CcbIsInput
|
|
FALSE, // IsDos
|
|
0, // Segment
|
|
0 // Offset
|
|
);
|
|
}
|
|
|
|
/***********************************************************************
|
|
|
|
picture this, if you will
|
|
|
|
NT READ CCB
|
|
|
|
+---------+
|
|
| |
|
|
| | NT RECEIVE CCB
|
|
| |
|
|
| | +---------+
|
|
| | | |
|
|
| | | |
|
|
| | | |
|
|
| u.pParameterTable-+ | |
|
|
+---------+ | | |
|
|
| | |
|
|
| | |
|
|
| | u.pParameterTable-+
|
|
| +---------+ |
|
|
v ^ |
|
|
+---------+ | |
|
|
NT READ parms | | | |
|
|
| | | v
|
|
| | | +---------+ EXTENDED NT
|
|
|ulNotificationFlag-+ | | RECEIVE PARMS
|
|
| | | |
|
|
|pFirstBuffer--+ | |
|
|
| | | | |
|
|
+---------+ | | |
|
|
| | |
|
|
| | |
|
|
| |dpOrigininalCcbAddress
|
|
| +---------+ |
|
|
v |
|
|
+---------+ |
|
|
| | |
|
|
first NT receive frame | | v
|
|
| | +---------+
|
|
| | DOS RECEIVE | |
|
|
| | CCB | |
|
|
| | | |
|
|
| | | |
|
|
| | | |
|
|
+---------+ | |
|
|
| |
|
|
+---------- |
|
|
| +---------+
|
|
|
|
|
|
|
|
|
|
|
v
|
|
+---------+
|
|
DOS RECEIVE parms | |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| - - - - -> DOS
|
|
| | receive
|
|
| | data
|
|
+---------+ buffers
|
|
|
|
to avoid the DLC device driver writing to the DOS RECEIVE parameter
|
|
table (because the NT RECEIVE parameter table is larger, and the
|
|
driver will corrupt DOS memory if we give it a DOS RECEIVE CCB), the
|
|
RECEIVE CCB is actually an NT RECEIVE CCB. The RECEIVE parameters are
|
|
in an extended table which contains the DOS address of the original
|
|
DOS RECEIVE CCB. When completing a DOS RECEIVE, we have to copy the
|
|
data from the NT frame to DOS buffers and put the address of the DOS
|
|
buffers in the DOS RECEIVE parameter table then call the DOS receive
|
|
data appendage
|
|
|
|
***********************************************************************/
|
|
|
|
pDosCcb = (PLLC_DOS_CCB)pReadParms->ulNotificationFlag;
|
|
dpDosCcb = ((PLLC_DOS_RECEIVE_PARMS_EX)pDosCcb->u.pParms)->dpOriginalCcbAddress;
|
|
pDosCcb = (PLLC_DOS_CCB)DOS_PTR_TO_FLAT(dpDosCcb);
|
|
pParms = (PLLC_DOS_PARMS)READ_FAR_POINTER(&pDosCcb->u.pParms);
|
|
pNtFrame = pReadParms->Type.Event.pReceivedFrame;
|
|
stationId = pNtFrame->Contiguous.usStationId;
|
|
sapNumber = SAP_ID(stationId);
|
|
|
|
IF_DEBUG(RX_DATA) {
|
|
DPUT3("VrDlcHwInterrupt: pNtFrame=%x pDosCcb=%x pParms=%x\n",
|
|
pNtFrame, pDosCcb, pParms);
|
|
}
|
|
|
|
//
|
|
// call ProcessReceiveFrame to find out what to do with this frame. If
|
|
// we accepted it then we can free the READ CCB and received NT buffer
|
|
// else we have to indicate local busy. N.B. The READ CCB pointed to
|
|
// by pReadCcb may well be a different READ CCB when this function
|
|
// returns
|
|
//
|
|
|
|
indication = ProcessReceiveFrame(&pReadCcb, pDosCcb, pParms, &Status);
|
|
switch (indication) {
|
|
case INDICATE_RECEIVE_FRAME:
|
|
|
|
//
|
|
// we have an I-Frame to indicate to the VDM. If we got the I-Frame
|
|
// from the deferred queue then generate another h/w interrupt
|
|
//
|
|
|
|
IF_DEBUG(RX_DATA) {
|
|
DPUT("INDICATE_RECEIVE_FRAME\n");
|
|
}
|
|
|
|
//
|
|
// set up the registers for the data received appendage:
|
|
//
|
|
// DS:SI = RECEIVE CCB
|
|
// ES:BX = received data buffer (Buffer 1)
|
|
// CX = adapter number
|
|
// AL = return code - STATUS_SUCCESS
|
|
// AH = 0x00
|
|
//
|
|
|
|
setDS(HIWORD(dpDosCcb));
|
|
setSI(LOWORD(dpDosCcb));
|
|
setES(GET_SEGMENT(&pParms->Receive.pFirstBuffer));
|
|
setBX(GET_OFFSET(&pParms->Receive.pFirstBuffer));
|
|
setAX((WORD)LLC_STATUS_SUCCESS);
|
|
setCX((WORD)pReadCcb->uchAdapterNumber);
|
|
setPostRoutine(READ_DWORD(&pParms->Receive.ulReceiveExit));
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("DATA_COMPLETION: ANR=%04x:%04x CCB=%04x:%04x Type=%02x Status=%02x Adapter=%04x\n",
|
|
HIWORD(READ_DWORD(&pParms->Receive.ulReceiveExit)),
|
|
LOWORD(READ_DWORD(&pParms->Receive.ulReceiveExit)),
|
|
getDS(),
|
|
getSI(),
|
|
pDosCcb->uchDlcCommand,
|
|
getAL(),
|
|
getCX()
|
|
));
|
|
}
|
|
|
|
IF_DEBUG(ASYNC_EVENT) {
|
|
DUMPCCB(POINTER_FROM_WORDS(getDS(), getSI()),
|
|
TRUE, // DumpAll
|
|
FALSE, // CcbIsInput
|
|
TRUE, // IsDos
|
|
getDS(),// Segment
|
|
getSI() // Offset
|
|
);
|
|
}
|
|
|
|
IF_DEBUG(RX_DATA) {
|
|
DPUT5("VrDlcHwInterrupt: received data @ %04x:%04x, CCB @ %04x:%04x. status=%02x\n",
|
|
getES(),
|
|
getBX(),
|
|
getDS(),
|
|
getSI(),
|
|
getAL()
|
|
);
|
|
}
|
|
|
|
break;
|
|
|
|
case INDICATE_LOCAL_BUSY:
|
|
|
|
//
|
|
// we have an I-Frame to receive, but no buffers. We have put NT
|
|
// DLC into LOCAL BUSY (Buffer) state for this link, we must tell
|
|
// the VDM that we are in LOCAL BUSY state
|
|
//
|
|
|
|
IF_DEBUG(RX_DATA) {
|
|
DPUT("INDICATE_LOCAL_BUSY\n");
|
|
}
|
|
|
|
//
|
|
// generate a DLC Status Change event & status table
|
|
//
|
|
|
|
iStation = iCurrentTempStatus++ & 7;
|
|
RtlZeroMemory((LPBYTE)&lpVdmWindow->aStatusTables[iStation], sizeof(struct _DOS_DLC_STATUS));
|
|
WRITE_WORD(&((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usStationId, stationId);
|
|
WRITE_WORD(&((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usDlcStatusCode, LLC_INDICATE_LOCAL_STATION_BUSY);
|
|
|
|
//
|
|
// Set the registers for DLC status change event: ES:BX point to the
|
|
// DLC status table containing the additional information; AX contains
|
|
// the status code; CX contains the adapter number; SI contains the
|
|
// value specified for USER_STAT_VALUE in the DLC.OPEN.SAP
|
|
//
|
|
|
|
newAddress = NEW_DOS_ADDRESS(dpVdmWindow, &lpVdmWindow->aStatusTables[iStation]);
|
|
setES(HIWORD(newAddress));
|
|
setBX(LOWORD(newAddress));
|
|
setAX(LLC_INDICATE_LOCAL_STATION_BUSY);
|
|
setCX((WORD)adapterNumber);
|
|
setSI(Adapters[adapterNumber].UserStatusValue[sapNumber]);
|
|
setPostRoutine(Adapters[adapterNumber].DlcStatusChangeAppendage[sapNumber]);
|
|
|
|
IF_DEBUG(STATUS_CHANGE) {
|
|
DPUT5("VrDlcHwInterrupt: Status Change info: ES:BX=%04x:%04x, AX=%04x, CX=%04x, SI=%04x\n",
|
|
getES(),
|
|
getBX(),
|
|
getAX(),
|
|
getCX(),
|
|
getSI()
|
|
);
|
|
DPUT4("VrDlcHwInterrupt: Status Change Exit = %04x:%04x, StationId=%04x, StatusCode=%04x\n",
|
|
HIWORD(Adapters[adapterNumber].DlcStatusChangeAppendage[sapNumber]),
|
|
LOWORD(Adapters[adapterNumber].DlcStatusChangeAppendage[sapNumber]),
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usStationId,
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usDlcStatusCode
|
|
);
|
|
}
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("LOCAL_BUSY: ES:BX=%04x:%04x, AX=%04x, CX=%04x, SI=%04x\n"
|
|
"Status Change Exit = %04x:%04x, StationId=%04x, StatusCode=%04x\n",
|
|
getES(),
|
|
getBX(),
|
|
getAX(),
|
|
getCX(),
|
|
getSI(),
|
|
HIWORD(Adapters[adapterNumber].DlcStatusChangeAppendage[sapNumber]),
|
|
LOWORD(Adapters[adapterNumber].DlcStatusChangeAppendage[sapNumber]),
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usStationId,
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usDlcStatusCode
|
|
));
|
|
}
|
|
break;
|
|
|
|
case INDICATE_COMPLETE_RECEIVE:
|
|
|
|
//
|
|
// a non I-Frame cannot be completed due to insufficient buffers.
|
|
// We will discard the frame, but we have to complete the
|
|
// outstanding RECEIVE, which means CANCELLING the outstanding
|
|
// NT RECEIVE (assuming that it didn't complete due to real LOCAL
|
|
// BUSY state)
|
|
//
|
|
|
|
IF_DEBUG(RX_DATA) {
|
|
DPUT("INDICATE_COMPLETE_RECEIVE\n");
|
|
}
|
|
|
|
//
|
|
// cancel the NT RECEIVE
|
|
//
|
|
|
|
ReceiveCancel(pReadCcb->uchAdapterNumber,
|
|
pReadParms->ulNotificationFlag
|
|
);
|
|
|
|
//
|
|
// we must delete any pending receives which reference this RECEIVE CCB
|
|
//
|
|
|
|
cancelledReceive = (PLLC_CCB)pReadParms->ulNotificationFlag;
|
|
|
|
//
|
|
// set up the registers to call the command completion appendage
|
|
// for the failed RECEIVE command
|
|
//
|
|
|
|
setES(HIWORD(dpDosCcb));
|
|
setBX(LOWORD(dpDosCcb));
|
|
setAL((UCHAR)Status);
|
|
setPostRoutine(READ_DWORD(&pDosCcb->ulCompletionFlag));
|
|
WRITE_BYTE(&pDosCcb->uchDlcStatus, Status);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("COMPLETE_RECEIVE: ANR=%04x:%04x CCB=%04x:%04x Type=%02x Status=%02x\n",
|
|
HIWORD(READ_DWORD(&pDosCcb->ulCompletionFlag)),
|
|
LOWORD(READ_DWORD(&pDosCcb->ulCompletionFlag)),
|
|
getES(),
|
|
getBX(),
|
|
pDosCcb->uchDlcCommand,
|
|
getAL()
|
|
));
|
|
}
|
|
break;
|
|
}
|
|
|
|
//
|
|
// if we have a non-NULL READ CCB pointer then we have to free the
|
|
// NT buffer and free the CCB
|
|
//
|
|
|
|
if (pReadCcb) {
|
|
BufferFree(pReadCcb->uchAdapterNumber,
|
|
pReadCcb->u.pParameterTable->Read.Type.Event.pReceivedFrame,
|
|
&buffersLeft
|
|
);
|
|
}
|
|
break;
|
|
|
|
case LLC_EVENT_STATUS_CHANGE:
|
|
|
|
//
|
|
// Event 0x08, 0x10, 0x20 & 0x40?
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcHwInterrupt: LLC_EVENT_STATUS_CHANGE\n");
|
|
}
|
|
|
|
//
|
|
// This heuristics tries to minimize the risk of overwritten
|
|
// DLC status indications and minimize the needed DOS memory.
|
|
// The first 5 link stations on each adapter has permanent
|
|
// status tables => apps requiring permanent status tables
|
|
// works fine up to 5 link connections. The first opened
|
|
// adapter may use also slots 5 - 10 for permanent status tables,
|
|
// if there is only one opened adapter. The last 5 slots
|
|
// are always reserved to routing of the status indications.
|
|
// This implementation takes 300 bytes DOS memory. The full
|
|
// support of all possible 510 link stations would take 10 kB memory.
|
|
// It's better save 10 kB DOS memory and have no configuration
|
|
// parameters, and accept a very low error probability
|
|
//
|
|
|
|
//
|
|
// decrement the station ID by 1 since we always start at station 1
|
|
// (0 is the SAP)
|
|
//
|
|
|
|
iStation = (pReadParms->Type.Status.usStationId & 0x00ff) - 1;
|
|
if (OpenedAdapters == 1 && iStation < DOS_DLC_STATUS_PERM_SLOTS) {
|
|
|
|
//
|
|
// We have only one adapter, use slots 1 - 10 for permanent tables
|
|
//
|
|
|
|
; // NOP
|
|
|
|
} else if (OpenedAdapters == 2 && iStation < (DOS_DLC_STATUS_PERM_SLOTS / 2)) {
|
|
|
|
//
|
|
// We have two adapters, use 5 slots for each adapter
|
|
// to have permanent status tables at least for the
|
|
// first station ids
|
|
//
|
|
|
|
iStation += (DOS_DLC_STATUS_PERM_SLOTS / 2) * adapterNumber;
|
|
} else {
|
|
|
|
//
|
|
// Use the slots reserve for temporary DLC status indications
|
|
//
|
|
|
|
iStation = iCurrentTempStatus;
|
|
iCurrentTempStatus = (iCurrentTempStatus + 1) % DOS_DLC_STATUS_TEMP_SLOTS;
|
|
}
|
|
|
|
//
|
|
// We must copy the DLC status block to the VDM address space. Note we
|
|
// actually use 3 bytes more than the CCB1 status tables, but since we
|
|
// are using pointers, it shouldn't matter
|
|
//
|
|
|
|
RtlCopyMemory((LPBYTE)&lpVdmWindow->aStatusTables[iStation],
|
|
&pReadParms->Type.Status,
|
|
sizeof(struct _DOS_DLC_STATUS)
|
|
);
|
|
|
|
//
|
|
// Set the registers for DLC status change event: ES:BX point to the
|
|
// DLC status table containing the additional information; AX contains
|
|
// the status code; CX contains the adapter number; SI contains the
|
|
// value specified for USER_STAT_VALUE in the DLC.OPEN.SAP
|
|
//
|
|
|
|
newAddress = NEW_DOS_ADDRESS(dpVdmWindow, &lpVdmWindow->aStatusTables[iStation]);
|
|
setES(HIWORD(newAddress));
|
|
setBX(LOWORD(newAddress));
|
|
setAX(pReadParms->Type.Status.usDlcStatusCode);
|
|
setCX((WORD)pReadCcb->uchAdapterNumber);
|
|
setSI(pReadParms->Type.Status.usUserStatusValue);
|
|
setPostRoutine(pReadParms->ulNotificationFlag);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("STATUS_CHANGE: ANR=%04x:%04x Status Table=%04x:%04x Status=%04x Adapter=%04x\n",
|
|
HIWORD(pReadParms->ulNotificationFlag),
|
|
LOWORD(pReadParms->ulNotificationFlag),
|
|
getES(),
|
|
getBX(),
|
|
getAX(),
|
|
getCX()
|
|
));
|
|
}
|
|
|
|
IF_DEBUG(STATUS_CHANGE) {
|
|
DPUT5("VrDlcHwInterrupt: Status Change info: ES:BX=%04x:%04x, AX=%04x, CX=%04x, SI=%04x\n",
|
|
getES(),
|
|
getBX(),
|
|
getAX(),
|
|
getCX(),
|
|
getSI()
|
|
);
|
|
DPUT4("VrDlcHwInterrupt: Status Change Exit = %04x:%04x, StationId=%04x, StatusCode=%04x\n",
|
|
HIWORD(pReadParms->ulNotificationFlag),
|
|
LOWORD(pReadParms->ulNotificationFlag),
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usStationId,
|
|
((PDOS_DLC_STATUS)&lpVdmWindow->aStatusTables[iStation])->usDlcStatusCode
|
|
);
|
|
}
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
//
|
|
// This should be impossible!
|
|
//
|
|
|
|
DPUT("VrDlcHwInterrupt: this is an impossible situation!\n");
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("VrDlcHwInterrupt: this is an impossible situation!\n"));
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
//
|
|
// if pReadCcb is not NULL, free the READ CCB & parameter table. If it is
|
|
// NULL then this means we did not complete processing of the READ CCB -
|
|
// it has more than 1 transmit CCB chained to it or it is a received frame
|
|
// which is on the deferred queue
|
|
//
|
|
|
|
if (pReadCcb) {
|
|
if (frameType == CURRENT) {
|
|
|
|
//
|
|
// RLF 09/24/92
|
|
//
|
|
// Remove the READ CCB from the head of the queue using GetEvent
|
|
// before freeing it. We got the pointer to the completed READ CCB
|
|
// from PeekEvent which left the READ at the head of the queue in
|
|
// case we needed to access the same completed READ for multiple
|
|
// transmit completions
|
|
//
|
|
|
|
#if DBG
|
|
|
|
//
|
|
// ensure that the CCB that we are removing from the head of the queue
|
|
// is the same one returned by PeekEvent
|
|
//
|
|
|
|
{
|
|
PLLC_CCB CcbAtQueueHead;
|
|
|
|
CcbAtQueueHead = GetEvent(adapterNumber);
|
|
if (pReadCcb != CcbAtQueueHead) {
|
|
DbgPrint("VrDlcHwInterrupt: "
|
|
"*** ERROR: GetEvent CCB (%x) != PeekEvent CCB (%x) ***\n",
|
|
CcbAtQueueHead,
|
|
pReadCcb
|
|
);
|
|
DbgBreakPoint();
|
|
}
|
|
}
|
|
|
|
#else
|
|
|
|
GetEvent(adapterNumber);
|
|
|
|
#endif
|
|
} else {
|
|
|
|
//
|
|
// READ CCB is at head of deferred queue. Remove it. If there are
|
|
// any more READ CCBs queued on this deferred queue then we have
|
|
// to generate an extra h/w interrupt
|
|
//
|
|
|
|
//
|
|
// PYS 03/18/02
|
|
//
|
|
// There are two cases where pReadCcb is NULL. Either
|
|
// LLC_EVENT_RECEIVE_DATA which calls ProcessReceiveFrame
|
|
// in which case we do have a valid stationId or
|
|
// LLC_EVENT_TRANSMIT_COMPLETE, in which case stationId is
|
|
// uninitialize as prefix will warn on the two calls down
|
|
// here with stationId. Since RemoveDeferredReceive asserts
|
|
// on 0 stationId, I added it as a sentinel above and will
|
|
// not call it when it occurs. I don't know how to generate
|
|
// this, so I leave a breakpoint in debug to catch this.
|
|
//
|
|
//
|
|
|
|
#if DBG
|
|
{
|
|
// ensure that the CCB that we are removing from the head of the queue
|
|
// is the same one returned by FindCompletedRead
|
|
//
|
|
|
|
PLLC_CCB CcbAtQueueHead;
|
|
|
|
CcbAtQueueHead = RemoveDeferredReceive(adapterNumber, stationId, &GetNewEvent);
|
|
if (pReadCcb != CcbAtQueueHead) {
|
|
DbgPrint("VrDlcHwInterrupt: "
|
|
"*** ERROR: GetEvent CCB (%x) != PeekEvent CCB (%x) ***\n",
|
|
CcbAtQueueHead,
|
|
pReadCcb
|
|
);
|
|
DbgBreakPoint();
|
|
}
|
|
if (GetNewEvent) {
|
|
reasonCode = 'R';
|
|
reasonCount = Adapters[adapterNumber].LocalBusyInfo[LINK_ID(stationId)].Depth;
|
|
}
|
|
}
|
|
#else
|
|
|
|
RemoveDeferredReceive(adapterNumber, stationId, &GetNewEvent);
|
|
|
|
#endif
|
|
}
|
|
|
|
LocalFree((HLOCAL)pReadCcb);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", pReadCcb);
|
|
}
|
|
|
|
}
|
|
|
|
//
|
|
// RLF 09/24/92
|
|
//
|
|
// Re-ordered issuing h/w int & removing freeing READ CCB since now that
|
|
// we peek first & remove later, we must be sure that a fully completed
|
|
// READ CCB is removed from the queue before we request a new h/w
|
|
// interrupt. I am not expecting this to be re-entered, but who knows
|
|
// what might happen on a MP machine?
|
|
//
|
|
|
|
if (GetNewEvent) {
|
|
|
|
//
|
|
// The event generates more than one appendage call. We need a new
|
|
// h/w interrupt for each extra appendage call
|
|
//
|
|
|
|
#if DBG
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("*** Calling ica_hw_interrupt from within ISR. Cause = %d %s ***\n",
|
|
reasonCount,
|
|
reasonCode == 'T' ? "multiple transmits" : "deferred I-Frames"
|
|
);
|
|
}
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** Calling ica_hw_interrupt from within ISR. Cause = %d %s ***\n",
|
|
reasonCount,
|
|
reasonCode == 'T' ? "multiple transmits" : "deferred I-Frames"
|
|
));
|
|
}
|
|
|
|
#endif
|
|
|
|
IssueHardwareInterrupt();
|
|
}
|
|
|
|
//
|
|
// if an NT RECEIVE CCB was completed or terminated, remove any pending
|
|
// READ CCBs completed by received data events which reference the terminated
|
|
// RECEIVE
|
|
//
|
|
|
|
if (cancelledReceive) {
|
|
RemoveDeadReceives(cancelledReceive);
|
|
|
|
LocalFree(cancelledReceive);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", cancelledReceive);
|
|
}
|
|
}
|
|
|
|
//
|
|
// acknowledge this hardware interrupt, meaning decrement the interrupt
|
|
// counter and issue a new request if we've got interrupts outstanding
|
|
//
|
|
|
|
AcknowledgeHardwareInterrupt();
|
|
|
|
//
|
|
// return TRUE to indicate that we have accepted the hw interrupt
|
|
//
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
|
|
PLLC_CCB
|
|
FindCompletedRead(
|
|
OUT READ_FRAME_TYPE* pFrameType
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Finds the next READ CCB to process - first looks at the event queue of
|
|
current completed CCBs, then at the deferred I-Frame queue.
|
|
|
|
This routine attempts to bounce between both adapters if they are both
|
|
active, in order not to only service the most active adapter and ignore
|
|
for a long period of time pending completed CCBs on the less active
|
|
adapter
|
|
|
|
NOTE: we only return a deferred I-Frame when the app has issued
|
|
DLC.FLOW.CONTROL against the station
|
|
|
|
Arguments:
|
|
|
|
pFrameType - returns the type of event found - CURRENT (event READ is at
|
|
head of EventQueue) or DEFERRED (event READ is at head of
|
|
a LOCAL_BUSY_INFO queue)
|
|
|
|
Return Value:
|
|
|
|
PLLC_CCB
|
|
pointer to completed READ CCB. The CCB is NOT DEQUEUED - the caller
|
|
must do that when the event has been completely disposed of to the VDM
|
|
|
|
--*/
|
|
|
|
{
|
|
DWORD i;
|
|
PLLC_CCB pCcb = NULL;
|
|
static BYTE ThisAdapter = 0;
|
|
|
|
for (i = 0; !Adapters[ThisAdapter].IsOpen && i < DOS_DLC_MAX_ADAPTERS; ++i) {
|
|
ThisAdapter = (ThisAdapter + 1) & (DOS_DLC_MAX_ADAPTERS - 1);
|
|
}
|
|
if (i == DOS_DLC_MAX_ADAPTERS) {
|
|
|
|
//
|
|
// no adapters alive?
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("*** FindCompletedRead: no open adapters??? ***\n");
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
//
|
|
// RLF 09/24/92
|
|
//
|
|
// Changed GetEvent to PeekEvent: if there are multiple chained completed
|
|
// CCBs (transmit+?) then we have to leave the READ CCB @ the head of the
|
|
// queue until we have generated call-backs for all chained completions.
|
|
// Only when there are no more completions can we remove the READ CCB from
|
|
// the queue (using GetEvent)
|
|
//
|
|
|
|
if (pCcb = PeekEvent(ThisAdapter)) {
|
|
*pFrameType = CURRENT;
|
|
} else {
|
|
|
|
//
|
|
// see if there are any deferred I-Frames
|
|
//
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("FindCompletedRead: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
ThisAdapter
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[ThisAdapter].LocalBusyCritSec);
|
|
|
|
//
|
|
// DeferredReceives is a reference count of link stations in emulated
|
|
// local-busy(buffer) state. They can be BUSY or CLEARING. We are only
|
|
// interested in CLEARING: this means that the app has issued
|
|
// DLC.FLOW.CONTROL to us & presumably has returned some buffers via
|
|
// BUFFER.FREE (if not, we just go back to BUSY state)
|
|
//
|
|
|
|
if (Adapters[ThisAdapter].DeferredReceives) {
|
|
for (i = Adapters[ThisAdapter].FirstIndex;
|
|
i <= Adapters[ThisAdapter].LastIndex; ++i) {
|
|
if (Adapters[ThisAdapter].LocalBusyInfo[i].State == CLEARING) {
|
|
if (pCcb = Adapters[ThisAdapter].LocalBusyInfo[i].Queue) {
|
|
*pFrameType = DEFERRED;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("FindCompletedRead: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
ThisAdapter
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[ThisAdapter].LocalBusyCritSec);
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("FindCompletedRead: returning READ CCB @ %08x type is %s\n",
|
|
pCcb,
|
|
*pFrameType == DEFERRED ? "DEFERRED" : "CURRENT"
|
|
);
|
|
}
|
|
|
|
//
|
|
// next time in, try the other adapter first
|
|
//
|
|
|
|
ThisAdapter = (ThisAdapter + 1) & (DOS_DLC_MAX_ADAPTERS - 1);
|
|
|
|
return pCcb;
|
|
}
|
|
|
|
|
|
INDICATION
|
|
ProcessReceiveFrame(
|
|
IN OUT PLLC_CCB* ppCcb,
|
|
IN LLC_DOS_CCB UNALIGNED * pDosCcb,
|
|
IN LLC_DOS_PARMS UNALIGNED * pDosParms,
|
|
OUT LLC_STATUS* Status
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Determines what to do with a received frame. We try to copy the received
|
|
frame to DOS buffers, but if we have insufficient buffers then we must
|
|
queue or discard the frame. We queue the frame only if it is an I-Frame.
|
|
We must first check the queue of deferred received frames or else risk
|
|
getting out-of-sequence received data in the DOS client.
|
|
|
|
When this routine is called, *ppCcb points at one of:
|
|
|
|
1. A deferred I-Frame READ CCB
|
|
2. A current received data READ CCB, I-Frame or other MAC/data
|
|
|
|
NOTE: Deferred I-Frames that are for stations whose local-busy(buffer)
|
|
state has been cleared by the app take precedence over the event
|
|
at the head of the EventQueue
|
|
|
|
Arguments:
|
|
|
|
ppCcb - pointer to new READ CCB. On output, this will be a non-NULL
|
|
value if we are to free the CCB and the received NT frame
|
|
buffer. If we placed the read on the deferred receive queue
|
|
then we return a NULL
|
|
|
|
pDosCcb - pointer to DOS CCB
|
|
|
|
pDosParms - pointer to DOS RECEIVE parameter table. If we copy - entirely
|
|
or partially - a frame, the DOS buffer chain is linked to
|
|
the DOS RECEIVE parameter table at FIRST_BUFFER
|
|
|
|
Status - if the frame was copied, contains the status to return to the
|
|
DOS appendage:
|
|
|
|
LLC_STATUS_SUCCESS
|
|
The frame was completely copied to the DOS buffer(s)
|
|
|
|
LLC_STATUS_LOST_DATA_NO_BUFFERS
|
|
The frame could not be copied to the DOS buffers and
|
|
has been discarded. There were NO buffers available.
|
|
The frame was NOT an I-Frame
|
|
|
|
LLC_STATUS_LOST_DATA_INADEQUATE_SPACE
|
|
The frame has been partially copied to the DOS buffer(s),
|
|
but the rest of it had to be discarded, because not
|
|
enough DOS buffers were available. The frame was NOT an
|
|
I-Frame
|
|
|
|
Status is only meaningful when INDICATE_COMPLETE_RECEIVE is
|
|
returned
|
|
|
|
Return Value:
|
|
|
|
INDICATION
|
|
INDICATE_RECEIVE_FRAME
|
|
We copied the frame to DOS buffers. Free the CCB and NT buffer and
|
|
return the frame to DOS
|
|
|
|
INDICATE_LOCAL_BUSY
|
|
We couldn't copy the received I-Frame to DOS buffers because we don't
|
|
have enough of them. We have put the NT link station into LOCAL BUSY
|
|
(Buffer) state. Indicate local busy to the VDM
|
|
|
|
INDICATE_COMPLETE_RECEIVE
|
|
We couldn't copy the received non I-Frame to DOS buffers. Complete
|
|
the DOS RECEIVE command with an error
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb = *ppCcb;
|
|
PLLC_PARMS pParms = pCcb->u.pParameterTable;
|
|
PLLC_BUFFER pFrame = pParms->Read.Type.Event.pReceivedFrame;
|
|
UCHAR adapter = pCcb->uchAdapterNumber;
|
|
WORD stationId = pFrame->Contiguous.usStationId;
|
|
WORD numBufs;
|
|
WORD bufferSize;
|
|
WORD buffersAvailable;
|
|
WORD nLeft;
|
|
DPLLC_DOS_BUFFER dosBuffers;
|
|
INDICATION indication;
|
|
LLC_STATUS status;
|
|
DWORD flags;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("ProcessReceiveFrame: adapter=%d, stationId=%x\n", adapter, stationId);
|
|
}
|
|
|
|
//
|
|
// make sure we don't read or write bogus Adapter structure
|
|
//
|
|
|
|
ASSERT(adapter < DOS_DLC_MAX_ADAPTERS);
|
|
|
|
//
|
|
// we are NOT chaining receive frames. DOS receive frame processing assumes
|
|
// that we get one frame at a time. Assert that it is so
|
|
//
|
|
|
|
ASSERT(pFrame->Contiguous.pNextFrame == NULL);
|
|
|
|
//
|
|
// get the contiguous and break flags for CopyFrame based on the RECEIVE options
|
|
//
|
|
|
|
flags = ((pFrame->Contiguous.uchOptions & (LLC_CONTIGUOUS_MAC | LLC_CONTIGUOUS_DATA))
|
|
? CF_CONTIGUOUS : 0)
|
|
| ((pFrame->Contiguous.uchOptions & LLC_BREAK) ? CF_BREAK : 0);
|
|
|
|
//
|
|
// calculate the number of buffers required to receive this frame
|
|
//
|
|
|
|
numBufs = CalculateBufferRequirement(adapter,
|
|
stationId,
|
|
pFrame,
|
|
pDosParms,
|
|
&bufferSize
|
|
);
|
|
|
|
//
|
|
// if the frame is an I-Frame then we have to perform these checks:
|
|
//
|
|
// 1. if there is already a deferred packet for this station ID/adapter
|
|
// then we must try to receive this before the frame in hand
|
|
//
|
|
// 2. if there aren't sufficient buffers for the request then we must
|
|
// queue this frame on the deferred queue (if it isn't there already)
|
|
// and indicate that we have a local busy (buffers) state to the DOS
|
|
// client
|
|
//
|
|
|
|
if (pFrame->Contiguous.uchMsgType == LLC_I_FRAME) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("ProcessReceiveFrame: I-Frame\n");
|
|
}
|
|
|
|
//
|
|
// try to allocate the required number of buffers as a chain - returns
|
|
// DOS pointers, ie unusable in flat data space. Note that if we have
|
|
// deferred receives then we may be able to satisfy the request now.
|
|
// We must allocate all the required buffers for an I-Frame, or none
|
|
//
|
|
|
|
status = GetBuffers(GET_POOL_INDEX(adapter, stationId),
|
|
numBufs,
|
|
&dosBuffers,
|
|
&nLeft,
|
|
FALSE,
|
|
NULL
|
|
);
|
|
if (status == LLC_STATUS_SUCCESS) {
|
|
|
|
//
|
|
// we managed to allocate the required number of DOS buffers. Copy
|
|
// the NT frame to the DOS buffers and set the indication to return
|
|
// the I-Frame and free the READ CCB and NT frame buffer
|
|
//
|
|
|
|
status = CopyFrame(pFrame,
|
|
dosBuffers,
|
|
READ_WORD(&pDosParms->Receive.usUserLength),
|
|
bufferSize,
|
|
flags
|
|
);
|
|
|
|
ASSERT(status == LLC_STATUS_SUCCESS);
|
|
|
|
indication = INDICATE_RECEIVE_FRAME;
|
|
} else {
|
|
|
|
//
|
|
// we couldn't get the required number of DOS buffers. We must
|
|
// queue this I-Frame (& any subsequent I-Frames received for this
|
|
// link station) on the deferred queue and indicate the local
|
|
// busy (buffers) state to the DOS client. Set pCcb to NULL to
|
|
// indicate that it mustn't be deallocated by the caller (it has
|
|
// already been deallocated in SetEmulatedLocalBusyState)
|
|
//
|
|
// We set the LOCAL BUSY (Buffer) state as quickly as possible: we
|
|
// don't want more than 1 I-Frame queued per link station if we
|
|
// can help it
|
|
//
|
|
|
|
SetEmulatedLocalBusyState(adapter, stationId);
|
|
pCcb = NULL;
|
|
indication = INDICATE_LOCAL_BUSY;
|
|
}
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("ProcessReceiveFrame: other MAC/DATA Frame\n");
|
|
}
|
|
|
|
//
|
|
// the frame is not an I-Frame. If we don't have sufficient buffers to
|
|
// receive it then we can discard it
|
|
//
|
|
|
|
status = GetBuffers(GET_POOL_INDEX(adapter, stationId),
|
|
numBufs,
|
|
&dosBuffers,
|
|
&nLeft,
|
|
TRUE,
|
|
&buffersAvailable
|
|
);
|
|
if (status == LLC_STATUS_SUCCESS) {
|
|
|
|
//
|
|
// we got some DOS buffers, but maybe not all requirement
|
|
//
|
|
|
|
if (buffersAvailable < numBufs) {
|
|
|
|
//
|
|
// set the status required to be returned to DOS in the completed
|
|
// RECEIVE CCB and set the CF_PARTIAL flag so that CopyFrame
|
|
// will know to terminate early
|
|
//
|
|
|
|
*Status = LLC_STATUS_LOST_DATA_INADEQUATE_SPACE;
|
|
flags |= CF_PARTIAL;
|
|
indication = INDICATE_COMPLETE_RECEIVE;
|
|
} else {
|
|
|
|
//
|
|
// we allocated all required DOS buffers for this frame
|
|
//
|
|
|
|
indication = INDICATE_RECEIVE_FRAME;
|
|
}
|
|
|
|
//
|
|
// copy the whole or partial frame
|
|
//
|
|
|
|
status = CopyFrame(pFrame,
|
|
dosBuffers,
|
|
READ_WORD(&pDosParms->Receive.usUserLength),
|
|
bufferSize,
|
|
flags
|
|
);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("ProcessReceiveFrame: CopyFrame (non-I-Frame) returns %x\n", status);
|
|
}
|
|
|
|
} else {
|
|
|
|
//
|
|
// no DOS buffers at all
|
|
//
|
|
|
|
*Status = LLC_STATUS_LOST_DATA_NO_BUFFERS;
|
|
indication = INDICATE_COMPLETE_RECEIVE;
|
|
}
|
|
}
|
|
|
|
//
|
|
// set the FIRST_BUFFER field in the DOS RECEIVE parameter table. This
|
|
// is only meaningful if we're going to complete the RECEIVE, with either
|
|
// success or failure status. Use WRITE_DWORD in case the parameter table
|
|
// is unaligned
|
|
//
|
|
|
|
WRITE_DWORD(&pDosParms->Receive.pFirstBuffer, dosBuffers);
|
|
|
|
//
|
|
// if we are returning DOS buffers, then return the BUFFERS_LEFT field
|
|
//
|
|
|
|
if (dosBuffers) {
|
|
|
|
PLLC_DOS_BUFFER pDosBuffer = (PLLC_DOS_BUFFER)DOS_PTR_TO_FLAT(dosBuffers);
|
|
|
|
WRITE_WORD(&pDosBuffer->Contiguous.cBuffersLeft, nLeft);
|
|
}
|
|
|
|
//
|
|
// set *ppCcb. If this contains non-NULL on return then the caller will
|
|
// deallocate the CCB and free the NT buffer(s)
|
|
//
|
|
|
|
*ppCcb = pCcb;
|
|
|
|
//
|
|
// return indication of action to take
|
|
//
|
|
|
|
return indication;
|
|
}
|
|
|
|
|
|
LOCAL_BUSY_STATE
|
|
QueryEmulatedLocalBusyState(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Gets the current local-busy(buffer) state of the requested link station on
|
|
a particular adapter
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter
|
|
StationId - which link station
|
|
|
|
Return Value:
|
|
|
|
LOCAL_BUSY_STATE
|
|
NOT_BUSY
|
|
AdapterNumber/StationId has no deferred I-Frames
|
|
|
|
BUSY
|
|
AdapterNumber/StationId has deferred I-Frames and has not yet
|
|
received DLC.FLOW.CONTROL(local-busy(buffer), reset) from the
|
|
DOS DLC app
|
|
|
|
CLEARING
|
|
AdapterNumber/StationId has deferred I-Frames AND has received
|
|
DLC.FLOW.CONTROL(local-busy(buffer), reset) from the DOS DLC app
|
|
and is currently trying to unload I-Frames to DOS DLC app
|
|
|
|
--*/
|
|
|
|
{
|
|
LOCAL_BUSY_STATE state;
|
|
|
|
ASSERT(HIBYTE(StationId) != 0);
|
|
ASSERT(LOBYTE(StationId) != 0);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("QueryEmulatedLocalBusyState: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
state = Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].State;
|
|
if (state == BUSY_BUFFER || state == BUSY_FLOW) {
|
|
state = BUSY;
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("QueryEmulatedLocalBusyState: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
|
|
ASSERT(state == NOT_BUSY
|
|
|| state == CLEARING
|
|
|| state == BUSY
|
|
|| state == BUSY_BUFFER
|
|
|| state == BUSY_FLOW
|
|
);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("QueryEmulatedLocalBusyState: returning %s\n",
|
|
state == NOT_BUSY
|
|
? "NOT_BUSY"
|
|
: state == CLEARING
|
|
? "CLEARING"
|
|
: state == BUSY
|
|
? "BUSY"
|
|
: state == BUSY_BUFFER
|
|
? "BUSY_BUFFER"
|
|
: "BUSY_FLOW"
|
|
);
|
|
}
|
|
|
|
return state;
|
|
}
|
|
|
|
|
|
VOID
|
|
SetEmulatedLocalBusyState(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Sets the emulated local-busy state to local-busy(buffer). If the state is
|
|
currently NOT_BUSY, sends a DLC.FLOW.CONTROL(local-busy(buffer), set) to
|
|
the DLC driver. In all cases sets the current state to BUSY
|
|
|
|
Called during processing of an I-Frame when we run out of DOS buffers into
|
|
which we receive the I-Frame. We can be processing a current I-Frame or a
|
|
deferred I-Frame at the time we run out of buffers: in the first instance
|
|
this routine sets local-busy(buffer) state for the first time; in the
|
|
second instance we regress into local-busy(buffer) state (BUSY) from the
|
|
CLEARING state. This will happen so long as we continue to run out of DOS
|
|
buffers
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to set emulated local busy state for
|
|
StationId - which link station on AdapterNumber
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
LOCAL_BUSY_STATE state;
|
|
DWORD link = LINK_ID(StationId);
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(HIBYTE(StationId) != 0); // SAP can't be 0
|
|
ASSERT(LOBYTE(StationId) != 0); // Link Station can't be 0
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("SetEmulatedLocalBusyState: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
state = Adapters[AdapterNumber].LocalBusyInfo[link].State;
|
|
|
|
ASSERT(state == NOT_BUSY
|
|
|| state == CLEARING
|
|
|| state == BUSY
|
|
|| state == BUSY_BUFFER
|
|
|| state == BUSY_FLOW
|
|
);
|
|
|
|
//
|
|
// if the state of this link station is currently NOT_BUSY then we have
|
|
// to stop the DLC driver receiving I-Frames for this station. In all
|
|
// cases, put the READ CCB on the end of the deferred queue for this
|
|
// adapter/link station
|
|
//
|
|
|
|
Adapters[AdapterNumber].LocalBusyInfo[link].State = BUSY;
|
|
|
|
//
|
|
// if the previous state was NOT_BUSY then this is the first time this link
|
|
// station has gone into local-busy(buffer) state. Increment the deferred
|
|
// receive count (number of links in local-busy(buffer) state on this
|
|
// adapter) and send a flow control command to the DLC driver, disabling
|
|
// further I-Frame receives until we clear the backlog
|
|
//
|
|
|
|
if (state == NOT_BUSY) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("SetEmulatedLocalBusyState: setting %d:%04x to BUSY from NOT_BUSY\n",
|
|
AdapterNumber,
|
|
StationId
|
|
);
|
|
}
|
|
|
|
++Adapters[AdapterNumber].DeferredReceives;
|
|
|
|
//
|
|
// update the indexes to reduce search effort when looking for deferred
|
|
// receives
|
|
//
|
|
|
|
ASSERT(Adapters[AdapterNumber].FirstIndex <= Adapters[AdapterNumber].LastIndex);
|
|
|
|
if (Adapters[AdapterNumber].FirstIndex > link) {
|
|
Adapters[AdapterNumber].FirstIndex = link;
|
|
}
|
|
if (Adapters[AdapterNumber].LastIndex < link
|
|
|| Adapters[AdapterNumber].LastIndex == NO_LINKS_BUSY) {
|
|
Adapters[AdapterNumber].LastIndex = link;
|
|
}
|
|
|
|
#if DBG
|
|
|
|
//ASSERT(DosDlcFlowControl(AdapterNumber, StationId, LLC_SET_LOCAL_BUSY_BUFFER) == LLC_STATUS_SUCCESS);
|
|
ASSERT(DlcFlowControl(AdapterNumber, StationId, LLC_SET_LOCAL_BUSY_USER) == LLC_STATUS_SUCCESS);
|
|
|
|
#else
|
|
|
|
//DosDlcFlowControl(AdapterNumber, StationId, LLC_SET_LOCAL_BUSY_BUFFER);
|
|
DlcFlowControl(AdapterNumber, StationId, LLC_SET_LOCAL_BUSY_USER);
|
|
|
|
#endif
|
|
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("SetEmulatedLocalBusyState: setting %d:%04x to BUSY from %s\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
state == CLEARING
|
|
? "CLEARING"
|
|
: state == BUSY_BUFFER
|
|
? "BUSY_BUFFER"
|
|
: state == BUSY_FLOW
|
|
? "BUSY_FLOW"
|
|
: "???"
|
|
);
|
|
}
|
|
}
|
|
|
|
ASSERT(state != BUSY);
|
|
|
|
//
|
|
// add this READ CCB to the end of the deferred receive queue for this
|
|
// adapter/link station and any subsequent READ CCBs which completed with
|
|
// received I-Frames
|
|
//
|
|
|
|
DeferAllIFrames(AdapterNumber, StationId);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT5("SetEmulatedLocalBusyState(%d, %04x): Ref#=%d, First=%d, Last=%d\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
Adapters[AdapterNumber].DeferredReceives,
|
|
Adapters[AdapterNumber].FirstIndex,
|
|
Adapters[AdapterNumber].LastIndex
|
|
);
|
|
}
|
|
|
|
//
|
|
// now reduce the priority of the event handler thread to give the CCB
|
|
// handler thread some time to free buffers & issue DLC.FLOW.CONTROL
|
|
// (mainly for DOS apps which do it in the wrong order)
|
|
//
|
|
|
|
SetThreadPriority(hEventThread, THREAD_PRIORITY_LOWEST);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("SetEmulatedLocalBusyState: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
}
|
|
|
|
|
|
BOOLEAN
|
|
ResetEmulatedLocalBusyState(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN BYTE DlcCommand
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Clears the local-busy(buffer) state for this adapter/link station. If the
|
|
transition is from BUSY to CLEARING then just changes the state and issues
|
|
a hardware interrupt to the VDM: the reason for this is that the original
|
|
interrupt from the READ which caused us to go into local-busy(buffer) state
|
|
was used to generate a DLC status change event
|
|
|
|
Called for a single link station or an entire SAP
|
|
|
|
Called in response to receiving DLC.FLOW.CONTROL(local-busy(buffer), reset)
|
|
from DOS app for a SAP or link station
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to clear the local-busy(buffer) state for
|
|
StationId - which link station on this adapter
|
|
DlcCommand - which DLC command is causing this reset
|
|
|
|
Return Value:
|
|
|
|
BOOLEAN
|
|
TRUE - state was reset from BUSY to CLEARING
|
|
FALSE - state is NOT_BUSY: invalid request
|
|
|
|
--*/
|
|
|
|
{
|
|
BOOLEAN reset;
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(HIBYTE(StationId) != 0); // SAP can't be 0
|
|
|
|
//
|
|
// grab the LocalBusyCritSec for the adapter and reset the local-busy(buffer)
|
|
// state for the link station or the entire SAP. If we are resetting for the
|
|
// entire SAP, holding the critical section ensures that new I-Frames won't
|
|
// cause another station to go into emulated local-busy(buffer) state while
|
|
// we are resetting the rest
|
|
//
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("ResetEmulatedLocalBusyState: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
|
|
if (LOBYTE(StationId) == 0) {
|
|
reset = ResetEmulatedLocalBusyStateSap(AdapterNumber, StationId, DlcCommand);
|
|
} else {
|
|
reset = ResetEmulatedLocalBusyStateLink(AdapterNumber, StationId, DlcCommand);
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("ResetEmulatedLocalBusyState: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
|
|
return reset;
|
|
}
|
|
|
|
|
|
BOOLEAN
|
|
ResetEmulatedLocalBusyStateSap(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN BYTE DlcCommand
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This function is called when the app resets the local-busy(buffer) state
|
|
for an entire SAP
|
|
|
|
NB: This function MUST BE CALLED WHILE HOLDING THE LocalBusyCritSec for
|
|
this adapter
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to
|
|
StationId - SAP:00 - which SAP to reset local-busy(buffer) states for
|
|
DlcCommand - which DLC command is causing this reset
|
|
|
|
Return Value:
|
|
|
|
BOOLEAN
|
|
TRUE - links reset for this SAP
|
|
FALSE - no links reset for this SAP
|
|
|
|
--*/
|
|
|
|
{
|
|
DWORD link = Adapters[AdapterNumber].FirstIndex;
|
|
DWORD last = Adapters[AdapterNumber].LastIndex;
|
|
DWORD count = 0;
|
|
LOCAL_BUSY_STATE state;
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(HIBYTE(StationId) != 0);
|
|
ASSERT(link <= last);
|
|
ASSERT(DlcCommand == LLC_BUFFER_FREE || DlcCommand == LLC_DLC_FLOW_CONTROL);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("ResetEmulatedLocalBusyStateSap(%d, %04x, %s)\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
DlcCommand == LLC_BUFFER_FREE ? "BUFFER.FREE"
|
|
: DlcCommand == LLC_DLC_FLOW_CONTROL ? "DLC.FLOW.CONTROL"
|
|
: "???"
|
|
);
|
|
}
|
|
|
|
//
|
|
// we may have a DLC.FLOW.CONTROL for a SAP which has already been reset
|
|
// by a previous DLC.FLOW.CONTROL
|
|
//
|
|
|
|
if (link == NO_LINKS_BUSY) {
|
|
|
|
ASSERT(last == NO_LINKS_BUSY);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("ResetEmulatedLocalBusyStateSap: SAP already reset\n");
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
//
|
|
// since we are holding the LocalBusyCritSec for this adapter, we can use
|
|
// FirstLink and LastLink to try reduce the number of searches for busy
|
|
// stations. No new stations can go busy and change FirstLink or LastLink
|
|
// while we are in this loop
|
|
//
|
|
|
|
for (++StationId; link <= last; ++StationId) {
|
|
state = Adapters[AdapterNumber].LocalBusyInfo[link].State;
|
|
++link;
|
|
if (state == BUSY
|
|
|| (state == BUSY_BUFFER && DlcCommand == LLC_DLC_FLOW_CONTROL)
|
|
|| (state == BUSY_FLOW && DlcCommand == LLC_BUFFER_FREE)) {
|
|
if (ResetEmulatedLocalBusyStateLink(AdapterNumber, StationId, DlcCommand)) {
|
|
++count;
|
|
}
|
|
}
|
|
}
|
|
|
|
return count != 0;
|
|
}
|
|
|
|
|
|
BOOLEAN
|
|
ResetEmulatedLocalBusyStateLink(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN BYTE DlcCommand
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This function is called when the app resets the local-busy(buffer) state
|
|
for a single link station
|
|
|
|
Clears the local-busy(buffer) state for this adapter/link station. If the
|
|
transition is from BUSY to CLEARING then just changes the state and issues
|
|
a hardware interrupt to the VDM: the reason for this is that the original
|
|
interrupt from the READ which caused us to go into local-busy(buffer) state
|
|
was used to generate a DLC status change event
|
|
|
|
NB: This function MUST BE CALLED WHILE HOLDING THE LocalBusyCritSec for
|
|
this adapter
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to clear the local-busy(buffer) state for
|
|
StationId - which link station on this adapter
|
|
DlcCommand - which DLC command is causing this reset
|
|
|
|
Return Value:
|
|
|
|
BOOLEAN
|
|
TRUE - state was reset from BUSY to CLEARING
|
|
FALSE - state is NOT_BUSY: invalid request
|
|
|
|
--*/
|
|
|
|
{
|
|
DWORD link = LINK_ID(StationId);
|
|
LOCAL_BUSY_STATE state;
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(HIBYTE(StationId) != 0); // SAP can't be 0
|
|
ASSERT(LOBYTE(StationId) != 0); // Link Station can't be 0
|
|
ASSERT(DlcCommand == LLC_BUFFER_FREE || DlcCommand == LLC_DLC_FLOW_CONTROL);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("ResetEmulatedLocalBusyStateLink(%d, %04x, %s)\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
DlcCommand == LLC_BUFFER_FREE ? "BUFFER.FREE"
|
|
: DlcCommand == LLC_DLC_FLOW_CONTROL ? "DLC.FLOW.CONTROL"
|
|
: "???"
|
|
);
|
|
}
|
|
|
|
state = Adapters[AdapterNumber].LocalBusyInfo[link].State;
|
|
|
|
ASSERT(state == NOT_BUSY
|
|
|| state == CLEARING
|
|
|| state == BUSY
|
|
|| state == BUSY_BUFFER
|
|
|| state == BUSY_FLOW
|
|
);
|
|
|
|
if (state == BUSY) {
|
|
|
|
//
|
|
// if the state is BUSY then this is the first DLC.FLOW.CONTROL or
|
|
// BUFFER.FREE since we went into local-busy(buffer) state. State
|
|
// transition is to BUSY_FLOW if this is a DLC.FLOW.CONTROL else
|
|
// BUSY_BUFFER
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("ResetEmulatedLocalBusyStateLink: state: BUSY -> %s\n",
|
|
DlcCommand == LLC_BUFFER_FREE ? "BUSY_BUFFER" : "BUSY_FLOW"
|
|
);
|
|
}
|
|
|
|
Adapters[AdapterNumber].LocalBusyInfo[link].State = (DlcCommand == LLC_BUFFER_FREE)
|
|
? BUSY_BUFFER
|
|
: BUSY_FLOW;
|
|
} else if ((state == BUSY_FLOW && DlcCommand == LLC_BUFFER_FREE)
|
|
|| (state == BUSY_BUFFER && DlcCommand == LLC_DLC_FLOW_CONTROL)) {
|
|
|
|
//
|
|
// state is BUSY_FLOW or BUSY_BUFFER. If this reset is caused by the
|
|
// other half of the state transition requirement then change the state
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("ResetEmulatedLocalBusyStateLink: link %d.%04x changing from %s to CLEARING\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
state == BUSY_FLOW ? "BUSY_FLOW" : "BUSY_BUFFER"
|
|
);
|
|
}
|
|
|
|
Adapters[AdapterNumber].LocalBusyInfo[link].State = CLEARING;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("ResetEmulatedLocalBusyStateLink: Interrupting VDM\n");
|
|
}
|
|
|
|
IssueHardwareInterrupt();
|
|
|
|
//
|
|
// for the benefit of the caller, the state was essentially BUSY
|
|
//
|
|
|
|
state = BUSY;
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("ResetEmulatedLocalBusyStateLink: NOT resetting state of %d.%04x. state is %s\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
state == CLEARING ? "CLEARING" : "NOT_BUSY"
|
|
);
|
|
}
|
|
|
|
}
|
|
|
|
return state == BUSY;
|
|
}
|
|
|
|
|
|
VOID
|
|
DeferReceive(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
IN PLLC_CCB pReadCcb
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Adds a READ CCB to the end of the deferred receive queue for an adapter/
|
|
station id
|
|
|
|
NB: This function MUST BE CALLED WHILE HOLDING THE LocalBusyCritSec for
|
|
this adapter
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to set emulated local busy state for
|
|
StationId - which link station on AdapterNumber
|
|
pReadCcb - pointer to completed received I-Frame CCB (NT READ CCB)
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB* pQueue;
|
|
PLLC_CCB pLlcCcb;
|
|
|
|
//
|
|
// if there is nothing in the queue for this adapter number/station ID
|
|
// then place this CCB at the head of the queue, else put the CCB at
|
|
// the end. The CCBs are chained together using their CCB_POINTER fields.
|
|
// Normally, this field is not used for received frame READ CCBs
|
|
//
|
|
|
|
ASSERT(pReadCcb->pNext == NULL);
|
|
ASSERT(HIBYTE(StationId) != 0);
|
|
ASSERT(LOBYTE(StationId) != 0);
|
|
|
|
#if DBG
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT4("DeferReceive: deferring I-Frame for %d.%04x. CCB = %08x. Current depth is %d\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
pReadCcb,
|
|
Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Depth
|
|
);
|
|
}
|
|
|
|
#endif
|
|
|
|
pQueue = &Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Queue;
|
|
pLlcCcb = *pQueue;
|
|
if (!pLlcCcb) {
|
|
*pQueue = pReadCcb;
|
|
} else {
|
|
for (; pLlcCcb->pNext; pLlcCcb = pLlcCcb->pNext) {
|
|
;
|
|
}
|
|
pLlcCcb->pNext = pReadCcb;
|
|
}
|
|
|
|
#if DBG
|
|
|
|
++Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Depth;
|
|
ASSERT(Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Depth <= MAX_I_FRAME_DEPTH);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("DeferReceive: %d.%04x CCB=%08x Depth=%d\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
pReadCcb,
|
|
Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Depth
|
|
));
|
|
}
|
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
|
VOID
|
|
DeferAllIFrames(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Removes all pending I-Frames for StationId from the EventQueue for this
|
|
adapter and places them on the deferred queue for this StationId.
|
|
|
|
This is done when the StationId goes into local-busy(buffer) state. We do
|
|
this so that any event packets behind the I-Frames can be completed, other
|
|
link stations which aren't blocked can receive their I-Frames and ensures
|
|
that once in local-busy state, all I-Frames are deferred for a link station
|
|
|
|
NB: This function MUST BE CALLED WHILE HOLDING THE LocalBusyCritSec for
|
|
this adapter
|
|
|
|
NB: we have to gain access to 2 critical sections - the LocalBusyCritSec
|
|
for this station ID & the EventQueueCritSec for this adapter
|
|
|
|
Assumption: This function is called in the context of the VDM h/w ISR and
|
|
before AcknowledgeHardwareInterrupt is called for this ISR BOP
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter structure to use
|
|
StationId - which link station to remove I-Frames for
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb;
|
|
PLLC_CCB next;
|
|
PLLC_CCB* last;
|
|
PLLC_READ_PARMS pReadParms;
|
|
PLLC_BUFFER pFrame;
|
|
BOOLEAN remove;
|
|
|
|
//
|
|
// deferredFrameCount starts at -1 because it is a count of pending h/w
|
|
// interrupts to cancel. We have to acknowledge the current one which will
|
|
// reduce the count by 1
|
|
//
|
|
|
|
LONG deferredFrameCount = -1;
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(HIBYTE(StationId) != 0);
|
|
ASSERT(LOBYTE(StationId) != 0);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("DeferAllIFrames: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
pCcb = Adapters[AdapterNumber].EventQueueHead;
|
|
last = &Adapters[AdapterNumber].EventQueueHead;
|
|
while (pCcb) {
|
|
pReadParms = &pCcb->u.pParameterTable->Read;
|
|
|
|
//
|
|
// only remove I-Frames from the EventQueue that are destined for this
|
|
// link station
|
|
//
|
|
|
|
remove = FALSE;
|
|
if (pReadParms->uchEvent == LLC_EVENT_RECEIVE_DATA) {
|
|
pFrame = pReadParms->Type.Event.pReceivedFrame;
|
|
if (pFrame->Contiguous.uchMsgType == LLC_I_FRAME
|
|
&& pFrame->Contiguous.usStationId == StationId) {
|
|
remove = TRUE;
|
|
}
|
|
}
|
|
if (remove) {
|
|
next = pCcb->pNext;
|
|
*last = next;
|
|
--Adapters[AdapterNumber].QueueElements;
|
|
if (Adapters[AdapterNumber].EventQueueTail == pCcb) {
|
|
if (last == &Adapters[AdapterNumber].EventQueueHead) {
|
|
Adapters[AdapterNumber].EventQueueTail = NULL;
|
|
} else {
|
|
Adapters[AdapterNumber].EventQueueTail = CONTAINING_RECORD(last, LLC_CCB, pNext);
|
|
}
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT3("DeferAllIFrames: moving CCB %08x for %d.%04x\n",
|
|
pCcb,
|
|
AdapterNumber,
|
|
StationId
|
|
);
|
|
}
|
|
|
|
pCcb->pNext = NULL;
|
|
DeferReceive(AdapterNumber, StationId, pCcb);
|
|
++deferredFrameCount;
|
|
pCcb = next;
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("DeferAllIFrames: not removing CCB %08x from EventQueue\n",
|
|
pCcb
|
|
);
|
|
}
|
|
|
|
last = (PLLC_CCB*)&pCcb->pNext;
|
|
pCcb = pCcb->pNext;
|
|
}
|
|
}
|
|
|
|
if (deferredFrameCount > 0) {
|
|
CancelHardwareInterrupts(deferredFrameCount);
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("DeferAllIFrames: LEAVING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
}
|
|
|
|
|
|
PLLC_CCB
|
|
RemoveDeferredReceive(
|
|
IN BYTE AdapterNumber,
|
|
IN WORD StationId,
|
|
OUT BOOLEAN* pDeferredFramesLeft
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Removes a READ CCB from the head of the deferred receive queue for an
|
|
adapter/station id and sets the head to point to the next deferred receive
|
|
in the queue
|
|
|
|
NB: This function MUST NOT BE CALLED WHILE HOLDING THE LocalBusyCritSec for
|
|
this adapter (opposite of DeferReceive)
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to set emulated local busy state for
|
|
StationId - which link station on AdapterNumber
|
|
pDeferredFramesLeft - TRUE if there are more frames on this deferred queue
|
|
|
|
Return Value:
|
|
|
|
PLLC_CCB
|
|
pointer to CCB from head of queue
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB* pQueue;
|
|
PLLC_CCB pLlcCcb;
|
|
DWORD link;
|
|
|
|
//
|
|
// if there is nothing in the queue for this adapter number/station ID
|
|
// then place this CCB at the head of the queue, else put the CCB at
|
|
// the end. The CCBs are chained together using their CCB_POINTER fields.
|
|
// Normally, this field is not used for received frame READ CCBs
|
|
//
|
|
|
|
if (StationId == 0)
|
|
{
|
|
#if DBG
|
|
DbgBreakPoint();
|
|
#endif
|
|
return(NULL);
|
|
}
|
|
|
|
link = LINK_ID(StationId);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("RemoveDeferredReceive: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
pQueue = &Adapters[AdapterNumber].LocalBusyInfo[link].Queue;
|
|
pLlcCcb = *pQueue;
|
|
*pQueue = pLlcCcb->pNext;
|
|
|
|
ASSERT(pLlcCcb != NULL);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT4("RemoveDeferredReceive: removing I-Frame for %d.%04x. CCB = %08x. Current depth is %d\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
pLlcCcb,
|
|
Adapters[AdapterNumber].LocalBusyInfo[LINK_ID(StationId)].Depth
|
|
);
|
|
}
|
|
|
|
#if DBG
|
|
|
|
--Adapters[AdapterNumber].LocalBusyInfo[link].Depth;
|
|
|
|
#endif
|
|
|
|
//
|
|
// if the deferred queue is now empty, reset the state and issue the real
|
|
// DLC.FLOW.CONTROL(local-busy(buffer), reset) to the DLC driver. Also
|
|
// reduce the reference count of link stations on this adapter in the
|
|
// local-busy(buffer) state and update the first and last link indicies
|
|
//
|
|
|
|
if (*pQueue == NULL) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("RemoveDeferredReceive: %d.%04x: change state to NOT_BUSY\n",
|
|
AdapterNumber,
|
|
StationId
|
|
);
|
|
}
|
|
|
|
Adapters[AdapterNumber].LocalBusyInfo[link].State = NOT_BUSY;
|
|
--Adapters[AdapterNumber].DeferredReceives;
|
|
if (Adapters[AdapterNumber].DeferredReceives) {
|
|
if (link == Adapters[AdapterNumber].FirstIndex) {
|
|
for (link = Adapters[AdapterNumber].FirstIndex + 1;
|
|
link <= Adapters[AdapterNumber].LastIndex;
|
|
++link) {
|
|
if (Adapters[AdapterNumber].LocalBusyInfo[link].State != NOT_BUSY) {
|
|
Adapters[AdapterNumber].FirstIndex = link;
|
|
break;
|
|
}
|
|
}
|
|
} else if (link == Adapters[AdapterNumber].LastIndex) {
|
|
for (link = Adapters[AdapterNumber].LastIndex - 1;
|
|
link >= Adapters[AdapterNumber].FirstIndex;
|
|
--link
|
|
) {
|
|
if (Adapters[AdapterNumber].LocalBusyInfo[link].State != NOT_BUSY) {
|
|
Adapters[AdapterNumber].LastIndex = link;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
Adapters[AdapterNumber].FirstIndex = NO_LINKS_BUSY;
|
|
Adapters[AdapterNumber].LastIndex = NO_LINKS_BUSY;
|
|
}
|
|
|
|
#if DBG
|
|
|
|
//ASSERT(DosDlcFlowControl(AdapterNumber, StationId, LLC_RESET_LOCAL_BUSY_BUFFER) == LLC_STATUS_SUCCESS);
|
|
ASSERT(DlcFlowControl(AdapterNumber, StationId, LLC_RESET_LOCAL_BUSY_USER) == LLC_STATUS_SUCCESS);
|
|
|
|
#else
|
|
|
|
//DosDlcFlowControl(AdapterNumber, StationId, LLC_RESET_LOCAL_BUSY_BUFFER);
|
|
DlcFlowControl(AdapterNumber, StationId, LLC_RESET_LOCAL_BUSY_USER);
|
|
|
|
#endif
|
|
|
|
*pDeferredFramesLeft = FALSE;
|
|
|
|
//
|
|
// restore async event thread's priority
|
|
//
|
|
|
|
SetThreadPriority(hEventThread, THREAD_PRIORITY_ABOVE_NORMAL);
|
|
} else {
|
|
*pDeferredFramesLeft = TRUE;
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT5("RemoveDeferredReceive(%d, %04x): Ref#=%d, First=%d, Last=%d\n",
|
|
AdapterNumber,
|
|
StationId,
|
|
Adapters[AdapterNumber].DeferredReceives,
|
|
Adapters[AdapterNumber].FirstIndex,
|
|
Adapters[AdapterNumber].LastIndex
|
|
);
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("RemoveDeferredReceive: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].LocalBusyCritSec);
|
|
return pLlcCcb;
|
|
}
|
|
|
|
|
|
DWORD
|
|
VrDlcEventHandlerThread(
|
|
IN PVOID pParameter
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This is the VDM DLC event handler thread. The thread reads all DLC events
|
|
from both DOS DLC adapters, queues them to the event queue and requests a
|
|
DOS hardware interrupt (the post routine mechanism uses hardware interrupts
|
|
to make an external event in the VDM)
|
|
|
|
To make this stuff as fast as possible, we don't allocate or free any memory
|
|
in this loop, but we reuse the old read CCBs and their parameter tables in
|
|
the event queue
|
|
|
|
We filter out any completion which will NOT result in an asynchronous event
|
|
in the VDM. This means CCB completions for this emulator (DIR.CLOSE.ADAPTER
|
|
and DIR.CLOSE.DIRECT for example) and received I-Frames for link stations
|
|
which are currently in the BUSY (local-busy(buffer)) state. This avoids us
|
|
making unnecessary interrupts in the VDM and costly (on x86 machines) BOPs
|
|
which achieve no action for the VDM
|
|
|
|
Arguments:
|
|
|
|
pParameter - not used
|
|
|
|
Return Value:
|
|
|
|
None, this should loop forever, until the VDM process dies
|
|
|
|
--*/
|
|
|
|
{
|
|
DWORD status = LLC_STATUS_PENDING;
|
|
DWORD waitIndex;
|
|
PLLC_CCB pReadCcb;
|
|
PLLC_READ_PARMS pReadParms;
|
|
WORD stationId;
|
|
|
|
UNREFERENCED_PARAMETER(pParameter);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("VrDlcEventHandlerThread kicked off: Thread Handle=%x, Id=%d\n",
|
|
GetCurrentThread(),
|
|
GetCurrentThreadId()
|
|
);
|
|
}
|
|
|
|
//
|
|
// wait for the READ CCB event for either adapter to become signalled (by
|
|
// DLC driver when READ completes)
|
|
//
|
|
|
|
while (TRUE) {
|
|
waitIndex = WaitForMultipleObjects(
|
|
ARRAY_ELEMENTS(aReadEvents), // count of objects
|
|
aReadEvents, // handle array
|
|
FALSE, // do not wait all objects
|
|
INFINITE // wait forever
|
|
);
|
|
|
|
//
|
|
// if we get 0xFFFFFFFF back then an error occurred
|
|
//
|
|
|
|
if (waitIndex == 0xffffffff) {
|
|
status = GetLastError();
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: FATAL: WaitForMultipleObjects returns %d\n", status);
|
|
}
|
|
|
|
//
|
|
// this terminates the thread!
|
|
//
|
|
|
|
break;
|
|
}
|
|
|
|
//
|
|
// if we get a number > number of events-1, then either a timeout
|
|
// occurred or a mutex was abandoned, both of which are highly
|
|
// improbable. Just continue with the loop
|
|
//
|
|
|
|
if (waitIndex > LAST_ELEMENT(aReadEvents)) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: ERROR: WaitForMultipleObjects returns %d?: continuing\n", waitIndex);
|
|
}
|
|
|
|
continue;
|
|
}
|
|
|
|
//
|
|
// one of the READ CCBs has successfully completed (oh joy!)
|
|
//
|
|
|
|
pReadCcb = aReadCcbs[waitIndex];
|
|
|
|
//
|
|
// reset the event
|
|
//
|
|
|
|
ResetEvent(aReadEvents[waitIndex]);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: Event occurred for adapter %d\n", waitIndex);
|
|
IF_DEBUG(READ_COMPLETE) {
|
|
DUMPCCB(pReadCcb, TRUE, FALSE, FALSE, 0, 0);
|
|
}
|
|
}
|
|
|
|
if (pReadCcb->uchDlcStatus == STATUS_SUCCESS) {
|
|
|
|
//
|
|
// it gets better!
|
|
//
|
|
|
|
pReadParms = &pReadCcb->u.pParameterTable->Read;
|
|
|
|
//
|
|
// if the completion flag is VRDLC_COMMAND_COMPLETION then this
|
|
// command originated in this emulator: Do Not hand it back to
|
|
// the VDM. In fact do nothing with it: this is an asynchronous
|
|
// command that we didn't want to wait for (like DIR.CLOSE.ADAPTER
|
|
// or DIR.CLOSE.DIRECT)
|
|
//
|
|
|
|
if (pReadParms->ulNotificationFlag == VRDLC_COMMAND_COMPLETION) {
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** VrDlcEventHandlerThread: VRDLC_COMMAND_COMPLETION: CCB=%08x COMMAND=%02x ***\n", pReadCcb, pReadCcb->uchDlcCommand));
|
|
}
|
|
|
|
} else if (pReadParms->uchEvent == LLC_EVENT_STATUS_CHANGE
|
|
&& pReadParms->Type.Status.usDlcStatusCode == LLC_INDICATE_LOCAL_STATION_BUSY
|
|
&& !IS_LOCAL_BUSY(waitIndex, pReadParms->Type.Status.usStationId)) {
|
|
|
|
//
|
|
// We must separate the buffer busy states of global NT
|
|
// buffer pool and the local buffer pools.
|
|
// This must be a real buffer busy indication, if
|
|
// the SAP has no overflowed receive buffers.
|
|
// How can such a situation arise - if we (ie DOS emulation) aren't
|
|
// holding onto the buffers, then where are they? Sounds like a bug
|
|
// to me (RLF 07/22/92)
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcEventHandlerThread: *** REAL LOCAL BUSY??? ***\n");
|
|
}
|
|
|
|
//
|
|
// We are not queueing buffers because of having
|
|
// no SAP buffers available => this must be a real
|
|
// buffer busy indication. The READ command should
|
|
// automatically extend the buffer pool size (up
|
|
// to the maximum value set in the initialization)
|
|
//
|
|
|
|
DlcFlowControl((BYTE)waitIndex, pReadParms->Type.Status.usStationId, LLC_RESET_LOCAL_BUSY_BUFFER);
|
|
|
|
} else if (pReadParms->uchEvent == LLC_EVENT_RECEIVE_DATA
|
|
&& pReadParms->Type.Event.pReceivedFrame->Contiguous.uchMsgType
|
|
== LLC_I_FRAME) {
|
|
|
|
stationId = pReadParms->Type.Event.pReceivedFrame->Contiguous.usStationId;
|
|
|
|
ASSERT(HIBYTE(stationId) != 0);
|
|
ASSERT(LOBYTE(stationId) != 0);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("VrDlcEventHandlerThread: ENTERING Adapters[%d].LocalBusyCritSec\n",
|
|
waitIndex
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[waitIndex].LocalBusyCritSec);
|
|
|
|
//
|
|
// if the link station is in emulated local-busy(buffer) state
|
|
// BUSY or CLEARING then queue the I-Frame. This action does NOT
|
|
// generate a h/w interrupt to the VDM. VrDlcHwInterrupt generates
|
|
// additional h/w interrupts when it processes deferred I-Frames
|
|
//
|
|
|
|
ASSERT(
|
|
Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State == NOT_BUSY
|
|
|| Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State == CLEARING
|
|
|| Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State == BUSY
|
|
|| Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State == BUSY_BUFFER
|
|
|| Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State == BUSY_FLOW
|
|
);
|
|
|
|
if (Adapters[waitIndex].LocalBusyInfo[LINK_ID(stationId)].State != NOT_BUSY) {
|
|
DeferReceive((BYTE)waitIndex, stationId, pReadCcb);
|
|
|
|
//
|
|
// set the READ CCB pointer to NULL: we have to allocate a
|
|
// new READ CCB
|
|
//
|
|
|
|
pReadCcb = NULL;
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("VrDlcEventHandlerThread: LEAVING Adapters[%d].LocalBusyCritSec\n",
|
|
waitIndex
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[waitIndex].LocalBusyCritSec);
|
|
}
|
|
|
|
//
|
|
// pReadCcb is NULL if the READ CCB is to be added to the event
|
|
// queue, NULL if we deferred an I-Frame for a link station in
|
|
// local-busy(buffer) state
|
|
//
|
|
|
|
if (pReadCcb) {
|
|
|
|
//
|
|
// queue the completed READ CCB in the event queue. If it is
|
|
// full (!) then wait. We will already have issued a call to
|
|
// call_ica_hw_interrupt for each of the events in the queue
|
|
// so we wait on the VDM removing events from the queue. This
|
|
// is an irregular situation, that I (RLF) don't expect to
|
|
// arise. If it does, then it probably means there is some
|
|
// horrendous inefficiency somewhere
|
|
//
|
|
|
|
PutEvent((BYTE)waitIndex, pReadCcb);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcEventHandlerThread: Interrupting VDM\n");
|
|
}
|
|
|
|
//
|
|
// poke the VDM so that it knows there is some asynchronous
|
|
// processing to do
|
|
//
|
|
|
|
IssueHardwareInterrupt();
|
|
|
|
//
|
|
// set pReadCcb to NULL. We have to allocate and submit a new
|
|
// READ CCB
|
|
//
|
|
|
|
pReadCcb = NULL;
|
|
}
|
|
} else {
|
|
|
|
//
|
|
// The READ function failed, the adapter must be closed. We now
|
|
// wait until the adapter is opened again and the event is set
|
|
// back to the signaled state
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: READ failed. Status=%x\n", pReadCcb->uchDlcStatus);
|
|
}
|
|
|
|
LocalFree(pReadCcb);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", pReadCcb);
|
|
}
|
|
|
|
//
|
|
// wait for a new READ CCB to be created the next time this adapter
|
|
// is opened
|
|
//
|
|
|
|
//continue;
|
|
pReadCcb = NULL;
|
|
}
|
|
|
|
//
|
|
// if we had a successful completion then get a new CCB. If the CCB was
|
|
// not queued, re-use it
|
|
//
|
|
|
|
if (!pReadCcb) {
|
|
pReadCcb = InitiateRead(waitIndex, (LLC_STATUS*)&status);
|
|
if (pReadCcb) {
|
|
status = pReadCcb->uchDlcStatus;
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("VrDlcEventHandlerThread: Error: InitiateRead returns NULL\n");
|
|
}
|
|
|
|
break;
|
|
}
|
|
} else {
|
|
status = lpAcsLan(pReadCcb, NULL);
|
|
if (status != LLC_STATUS_SUCCESS) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: Error: AcsLan returns %d\n", status);
|
|
}
|
|
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
//
|
|
// !!! WE SHOULD NEVER BE HERE !!!
|
|
//
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("VrDlcEventHandlerThread: Fatal: terminating. Status = %x\n", status);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
BOOLEAN
|
|
InitializeEventHandler(
|
|
VOID
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Initializes static data structures used in event handling
|
|
|
|
Arguments:
|
|
|
|
None
|
|
|
|
Return Value:
|
|
|
|
BOOLEAN
|
|
Success - TRUE
|
|
Failure - FALSE
|
|
|
|
--*/
|
|
|
|
{
|
|
DWORD i;
|
|
DWORD Tid;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("Vr: InitializeEventHandler\n");
|
|
}
|
|
|
|
//
|
|
// make sure the read CCBs and event queues are in a known state
|
|
//
|
|
|
|
RtlZeroMemory(aReadCcbs, sizeof(aReadCcbs));
|
|
|
|
//
|
|
// preset the handle array with invalid handles so we know which ones
|
|
// have been allocated in clean up
|
|
//
|
|
|
|
for (i = 0; i < ARRAY_ELEMENTS(aReadEvents); ++i) {
|
|
aReadEvents[i] = INVALID_HANDLE_VALUE;
|
|
}
|
|
|
|
//
|
|
// create event handles for all (both) supported adapters. DIR.OPEN.ADAPTER
|
|
// sets the event to signalled which enables the event handler thread to
|
|
// receive events for that adapter. If we get an error creating the handles
|
|
// then clean up before exiting so that we may try this again later
|
|
//
|
|
|
|
for (i = 0; i < ARRAY_ELEMENTS(aReadEvents); i++) {
|
|
aReadEvents[i] = CreateEvent(NULL, // security attributes: no inherit
|
|
TRUE, // manual-reset event
|
|
FALSE, // initial state = not signaled
|
|
NULL // unnamed event
|
|
);
|
|
if (aReadEvents[i] == NULL) {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("Vr: InitializeEventHandler: Error: failed to create read event: %d\n", GetLastError());
|
|
}
|
|
|
|
goto cleanUp;
|
|
}
|
|
}
|
|
|
|
//
|
|
// create and start the thread which handles RECEIVE events
|
|
//
|
|
|
|
hEventThread = CreateThread(NULL, // security attributes
|
|
EVENT_THREAD_STACK, // initial thread stack size
|
|
VrDlcEventHandlerThread,
|
|
NULL, // thread args
|
|
0, // creation flags
|
|
&Tid
|
|
);
|
|
if (hEventThread) {
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("InitializeEventHandler: Created thread Handle=%x, Tid=%d\n", hEventThread, Tid));
|
|
}
|
|
|
|
SetThreadPriority(hEventThread, THREAD_PRIORITY_ABOVE_NORMAL);
|
|
return TRUE;
|
|
} else {
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("Vr: InitializeEventHandler: Error: failed to create thread: %d\n", GetLastError());
|
|
}
|
|
|
|
}
|
|
|
|
//
|
|
// we come here if for some reason we couldn't create the event handles or
|
|
// the event handler thread
|
|
//
|
|
|
|
cleanUp:
|
|
for (i = 0; i < ARRAY_ELEMENTS(aReadEvents); ++i) {
|
|
if (aReadEvents[i] != INVALID_HANDLE_VALUE) {
|
|
CloseHandle(aReadEvents[i]);
|
|
}
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("InitializeEventHandler: Error: returning FALSE\n");
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
|
|
PLLC_CCB
|
|
InitiateRead(
|
|
IN DWORD AdapterNumber,
|
|
OUT LLC_STATUS* ErrorStatus
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Create a READ CCB, initialize it to get all events for all stations, set
|
|
the completion event to the event created for this adapter and submit the
|
|
CCB (via AcsLan). If the submit succeeds, set this CCB as the READ CCB
|
|
for AdapterNumber
|
|
|
|
NB: The READ CCB - which will be queued on EventQueue - and its parameter
|
|
table are allocated together, so we only need one call to LocalFree to
|
|
deallocate both
|
|
|
|
This routine IS THE ONLY PLACE WHERE aReadCcbs IS WRITTEN once the array
|
|
has been initialized in InitializeEventHandler
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to initiate this READ for
|
|
|
|
ErrorStatus - returned LLC_STATUS describing failure if this function
|
|
returns NULL
|
|
|
|
Return Value:
|
|
|
|
PLLC_CCB
|
|
pointer to allocated/submitted CCB or NULL.
|
|
|
|
If this function succeeds then aReadCcbs[AdapterNumber] points to the
|
|
READ CCB
|
|
|
|
If this function fails then *ErrorStatus will contain an LLC_STATUS
|
|
describing why we failed to allocate/submit the CCB. The CCB will be
|
|
deallocated in this case
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb;
|
|
PLLC_READ_PARMS parms;
|
|
LLC_STATUS status;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("InitiateRead: AdapterNumber=%d\n", AdapterNumber);
|
|
}
|
|
|
|
//
|
|
// Allocate, initialize and issue the next DLC command. Allocate contiguous
|
|
// space for CCB and parameter table
|
|
//
|
|
|
|
pCcb = (PLLC_CCB)LocalAlloc(LMEM_FIXED | LMEM_ZEROINIT,
|
|
sizeof(LLC_CCB) + sizeof(LLC_READ_PARMS)
|
|
);
|
|
|
|
//
|
|
// put the READ CCB in the array before we have a chance to complete it
|
|
//
|
|
|
|
aReadCcbs[AdapterNumber] = pCcb;
|
|
if (pCcb) {
|
|
|
|
//
|
|
// initialize required CCB fields
|
|
//
|
|
|
|
pCcb->uchAdapterNumber = (UCHAR)AdapterNumber;
|
|
pCcb->uchDlcCommand = LLC_READ;
|
|
parms = (PLLC_READ_PARMS)&pCcb[1];
|
|
pCcb->u.pParameterTable = (PLLC_PARMS)parms;
|
|
pCcb->hCompletionEvent = aReadEvents[AdapterNumber];
|
|
|
|
//
|
|
// set the read options to receive ALL events for ALL stations
|
|
//
|
|
|
|
parms->uchOptionIndicator = LLC_OPTION_READ_ALL;
|
|
parms->uchEventSet = LLC_READ_ALL_EVENTS;
|
|
|
|
//
|
|
// submit the CCB. If it's not ok, free the CCB and NULL the pointer
|
|
// in the list of per-adapter READ CCBs
|
|
//
|
|
|
|
status = lpAcsLan(pCcb, NULL);
|
|
if (status != LLC_STATUS_SUCCESS) {
|
|
|
|
aReadCcbs[AdapterNumber] = NULL;
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("InitiateRead: AcsLan failed: %x\n", status);
|
|
}
|
|
|
|
LocalFree((HLOCAL)pCcb);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", pCcb);
|
|
}
|
|
|
|
*ErrorStatus = status;
|
|
pCcb = NULL;
|
|
}
|
|
} else {
|
|
*ErrorStatus = LLC_STATUS_NO_MEMORY;
|
|
}
|
|
|
|
#if DBG
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT2("InitiateRead: returning pCcb=%x%c", pCcb, pCcb ? '\n' : ' ');
|
|
if (!pCcb) {
|
|
DPUT1("*ErrorStatus=%x\n", *ErrorStatus);
|
|
}
|
|
}
|
|
|
|
#endif
|
|
|
|
return pCcb;
|
|
}
|
|
|
|
|
|
VOID
|
|
PutEvent(
|
|
IN BYTE AdapterNumber,
|
|
IN PLLC_CCB pCcb
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Adds a completed event (READ CCB) to the Event Queue. If the event queue
|
|
is full then returns FALSE. Updates the queue tail index. The queue is
|
|
accessed inside a critical section
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter to queue event for
|
|
pCcb - pointer to completed READ CCB to add to the queue
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
ASSERT(pCcb->pNext == NULL);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("PutEvent: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
if (Adapters[AdapterNumber].EventQueueTail == NULL) {
|
|
Adapters[AdapterNumber].EventQueueHead = pCcb;
|
|
} else {
|
|
Adapters[AdapterNumber].EventQueueTail->pNext = pCcb;
|
|
}
|
|
Adapters[AdapterNumber].EventQueueTail = pCcb;
|
|
++Adapters[AdapterNumber].QueueElements;
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT5("PutEvent: Added %x to adapter %d EventQueue. Head=%x Tail=%x Elements=%d\n",
|
|
pCcb,
|
|
AdapterNumber,
|
|
Adapters[AdapterNumber].EventQueueHead,
|
|
Adapters[AdapterNumber].EventQueueTail,
|
|
Adapters[AdapterNumber].QueueElements
|
|
);
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("PutEvent: LEAVING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
}
|
|
|
|
|
|
PLLC_CCB
|
|
PeekEvent(
|
|
IN BYTE AdapterNumber
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Reads the next completed CCB from the head of the Event Queue. If the
|
|
queue is empty (QueueElements == 0) then returns NULL. The queue is
|
|
accessed inside a critical section
|
|
|
|
Arguments:
|
|
|
|
None.
|
|
|
|
Return Value:
|
|
|
|
PLLC_CCB
|
|
Success - pointer to CCB at queue head
|
|
Failure - NULL
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb;
|
|
|
|
ASSERT(AdapterNumber < DOS_DLC_MAX_ADAPTERS);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("PeekEvent: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
if (Adapters[AdapterNumber].QueueElements) {
|
|
pCcb = Adapters[AdapterNumber].EventQueueHead;
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT5("PeekEvent: CCB %x from adapter %d queue head. Head=%x Tail=%x Elements=%d\n",
|
|
pCcb,
|
|
AdapterNumber,
|
|
Adapters[AdapterNumber].EventQueueHead,
|
|
Adapters[AdapterNumber].EventQueueTail,
|
|
Adapters[AdapterNumber].QueueElements
|
|
);
|
|
}
|
|
|
|
} else {
|
|
pCcb = NULL;
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT1("PeekEvent: adapter %d queue is EMPTY!\n", AdapterNumber);
|
|
}
|
|
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("PeekEvent: LEAVING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("PeekEvent: returning %x\n", pCcb));
|
|
}
|
|
|
|
return pCcb;
|
|
}
|
|
|
|
|
|
PLLC_CCB
|
|
GetEvent(
|
|
IN BYTE AdapterNumber
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Gets the next completed CCB from the head of the Event Queue. If the
|
|
queue is empty (QueueElements == 0) then returns NULL. If there is a
|
|
completed event in the queue, removes it and advances the queue head
|
|
to the next element. The queue is accessed inside a critical section
|
|
|
|
Arguments:
|
|
|
|
AdapterNumber - which adapter's event queue to remove event from
|
|
|
|
Return Value:
|
|
|
|
PLLC_CCB
|
|
Success - pointer to dequeued CCB
|
|
Failure - NULL
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb;
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("GetEvent: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
if (Adapters[AdapterNumber].QueueElements) {
|
|
pCcb = Adapters[AdapterNumber].EventQueueHead;
|
|
Adapters[AdapterNumber].EventQueueHead = pCcb->pNext;
|
|
--Adapters[AdapterNumber].QueueElements;
|
|
if (Adapters[AdapterNumber].QueueElements == 0) {
|
|
Adapters[AdapterNumber].EventQueueTail = NULL;
|
|
}
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT5("GetEvent: Removed %x from adapter %d EventQueue. Head=%x Tail=%x Elements=%d\n",
|
|
pCcb,
|
|
AdapterNumber,
|
|
Adapters[AdapterNumber].EventQueueHead,
|
|
Adapters[AdapterNumber].EventQueueTail,
|
|
Adapters[AdapterNumber].QueueElements
|
|
);
|
|
}
|
|
|
|
} else {
|
|
pCcb = NULL;
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT1("GetEvent: queue for adapter %d is EMPTY!\n", AdapterNumber);
|
|
}
|
|
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("GetEvent: LEAVING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("GetEvent: returning %x\n", pCcb));
|
|
}
|
|
|
|
return pCcb;
|
|
}
|
|
|
|
|
|
VOID
|
|
FlushEventQueue(
|
|
IN BYTE AdapterNumber
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Removes all READ CCBs from the event queue.
|
|
|
|
Arguments:
|
|
|
|
None.
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB pCcb;
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("FlushEventQueue: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
EnterCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
|
|
#if DBG
|
|
|
|
if (!Adapters[AdapterNumber].QueueElements) {
|
|
DPUT("FlushEventQueue: queue is EMPTY!\n");
|
|
}
|
|
|
|
#endif
|
|
|
|
while (Adapters[AdapterNumber].QueueElements) {
|
|
pCcb = Adapters[AdapterNumber].EventQueueHead;
|
|
--Adapters[AdapterNumber].QueueElements;
|
|
Adapters[AdapterNumber].EventQueueHead = pCcb->pNext;
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT5("FlushEventQueue: Removed %x from adapter %d EventQueue. Head=%x Tail=%x Elements=%d\n",
|
|
pCcb,
|
|
AdapterNumber,
|
|
Adapters[AdapterNumber].EventQueueHead,
|
|
Adapters[AdapterNumber].EventQueueTail,
|
|
Adapters[AdapterNumber].QueueElements
|
|
);
|
|
}
|
|
|
|
//
|
|
// BUGBUG - received frames?
|
|
//
|
|
|
|
LocalFree((HLOCAL)pCcb);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", pCcb);
|
|
}
|
|
|
|
Adapters[AdapterNumber].EventQueueTail = NULL;
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT1("FlushEventQueue: ENTERING Adapters[%d].EventQueueCritSec\n",
|
|
AdapterNumber
|
|
);
|
|
}
|
|
|
|
LeaveCriticalSection(&Adapters[AdapterNumber].EventQueueCritSec);
|
|
}
|
|
|
|
|
|
VOID
|
|
RemoveDeadReceives(
|
|
IN PLLC_CCB pCcb
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
The receive command described by pCcb has completed (terminated). We must
|
|
remove any queued reads completed by data receive which refer to this CCB
|
|
|
|
Arguments:
|
|
|
|
pCcb - pointer to RECEIVE CCB (NT)
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
PLLC_CCB thisCcb;
|
|
PLLC_CCB nextCcb;
|
|
PLLC_CCB lastCcb = NULL;
|
|
PLLC_CCB prevCcb = NULL;
|
|
DWORD i;
|
|
PDOS_ADAPTER pAdapter = &Adapters[pCcb->uchAdapterNumber];
|
|
PLLC_CCB* pQueue;
|
|
|
|
//
|
|
// remove any queued receives from the event queue. Note: There should NOT
|
|
// be any. The reason: there can't be any data received after the associated
|
|
// RECEIVE command has been cancelled or terminated. This is the theory,
|
|
// anyway
|
|
//
|
|
|
|
EnterCriticalSection(&pAdapter->EventQueueCritSec);
|
|
thisCcb = pAdapter->EventQueueHead;
|
|
for (i = pAdapter->QueueElements; i; --i) {
|
|
nextCcb = thisCcb->pNext;
|
|
if (thisCcb->u.pParameterTable->Read.ulNotificationFlag == (ULONG)pCcb) {
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT5("RemoveDeadReceives: Removed %x from adapter %d EventQueue. Head=%x Tail=%x Elements=%d\n",
|
|
thisCcb,
|
|
pCcb->uchAdapterNumber,
|
|
pAdapter->EventQueueHead,
|
|
pAdapter->EventQueueTail,
|
|
pAdapter->QueueElements
|
|
);
|
|
}
|
|
|
|
ReleaseReceiveResources(thisCcb);
|
|
|
|
if (pAdapter->EventQueueHead == thisCcb) {
|
|
pAdapter->EventQueueHead = nextCcb;
|
|
}
|
|
--pAdapter->QueueElements;
|
|
lastCcb = thisCcb;
|
|
} else {
|
|
prevCcb = thisCcb;
|
|
}
|
|
thisCcb = nextCcb;
|
|
}
|
|
if (pAdapter->EventQueueTail == lastCcb) {
|
|
pAdapter->EventQueueTail = prevCcb;
|
|
}
|
|
LeaveCriticalSection(&pAdapter->EventQueueCritSec);
|
|
|
|
//
|
|
// remove any queued deferred receives from the deferred I-Frame queue for
|
|
// this SAP or link station
|
|
//
|
|
|
|
EnterCriticalSection(&pAdapter->LocalBusyCritSec);
|
|
if (pAdapter->DeferredReceives) {
|
|
|
|
ASSERT(pAdapter->FirstIndex != NO_LINKS_BUSY);
|
|
ASSERT(pAdapter->LastIndex != NO_LINKS_BUSY);
|
|
|
|
for (i = pAdapter->FirstIndex; i <= pAdapter->LastIndex; ++i) {
|
|
pQueue = &pAdapter->LocalBusyInfo[i].Queue;
|
|
for (thisCcb = *pQueue; thisCcb; thisCcb = thisCcb->pNext) {
|
|
if (thisCcb->u.pParameterTable->Read.ulNotificationFlag == (ULONG)pCcb) {
|
|
|
|
IF_DEBUG(EVENT_QUEUE) {
|
|
DPUT3("RemoveDeadReceives: Removed %x from adapter %d BusyList. Queue=%x\n",
|
|
thisCcb,
|
|
pCcb->uchAdapterNumber,
|
|
pAdapter->LocalBusyInfo[i].Queue
|
|
);
|
|
}
|
|
|
|
*pQueue = thisCcb->pNext;
|
|
ReleaseReceiveResources(thisCcb);
|
|
|
|
#if DBG
|
|
--pAdapter->LocalBusyInfo[i].Depth;
|
|
#endif
|
|
|
|
thisCcb = *pQueue;
|
|
} else {
|
|
pQueue = &thisCcb->pNext;
|
|
}
|
|
}
|
|
if (pAdapter->LocalBusyInfo[i].Queue == NULL) {
|
|
pAdapter->LocalBusyInfo[i].State = NOT_BUSY;
|
|
--pAdapter->DeferredReceives;
|
|
}
|
|
}
|
|
|
|
//
|
|
// reset the indicies
|
|
//
|
|
|
|
if (pAdapter->DeferredReceives) {
|
|
for (i = pAdapter->FirstIndex; i <= pAdapter->LastIndex; ++i) {
|
|
if (pAdapter->LocalBusyInfo[i].State != NOT_BUSY) {
|
|
pAdapter->FirstIndex = i;
|
|
break;
|
|
}
|
|
}
|
|
for (i = pAdapter->LastIndex; i > pAdapter->FirstIndex; --i) {
|
|
if (pAdapter->LocalBusyInfo[i].State != NOT_BUSY) {
|
|
pAdapter->LastIndex = i;
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
pAdapter->FirstIndex = NO_LINKS_BUSY;
|
|
pAdapter->LastIndex = NO_LINKS_BUSY;
|
|
}
|
|
}
|
|
LeaveCriticalSection(&pAdapter->LocalBusyCritSec);
|
|
}
|
|
|
|
|
|
VOID
|
|
ReleaseReceiveResources(
|
|
IN PLLC_CCB pCcb
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Releases all resources used by a completed data receive READ CCB
|
|
|
|
Arguments:
|
|
|
|
pCcb - pointer to completed READ CCB. We have to return all received
|
|
frames to buffer pool, and the READ CCB and parameter table to
|
|
the proceess heap
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
WORD buffersLeft;
|
|
|
|
//
|
|
// this is a data receive - return the data buffers to the pool
|
|
//
|
|
|
|
ASSERT(pCcb->u.pParameterTable->Read.uchEvent == LLC_EVENT_RECEIVE_DATA);
|
|
|
|
BufferFree(pCcb->uchAdapterNumber,
|
|
pCcb->u.pParameterTable->Read.Type.Event.pReceivedFrame,
|
|
&buffersLeft
|
|
);
|
|
|
|
//
|
|
// free the READ CCB and parameter table
|
|
//
|
|
|
|
LocalFree((HLOCAL)pCcb);
|
|
|
|
IF_DEBUG(DLC_ALLOC) {
|
|
DPUT1("FREE: freed block @ %x\n", pCcb);
|
|
}
|
|
}
|
|
|
|
|
|
VOID
|
|
IssueHardwareInterrupt(
|
|
VOID
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Issue a simulated hardware interrupt to the VDM. This routine exists because
|
|
we were losing interrupts - seeing more calls to call_ica_hw_interrupt than
|
|
calls to VrDlcHwInterrupt. Hence presumably simulated interrupts were being
|
|
lost. So we now only have 1 un-acknowledged simulated interrupt outstanding
|
|
at any one time. If we already have interrupts outstanding then we just
|
|
increment a counter of pending interrupts. When we dismiss the current
|
|
interrupt using the companion routine AcknowledgeHardwareInterrupt, we can
|
|
generate at that point a queued interrupt
|
|
|
|
Arguments:
|
|
|
|
None.
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** INT ***\n"));
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("*** INT ***\n");
|
|
}
|
|
|
|
//
|
|
// increment the hardware interrupt counter under critical section control.
|
|
// The counter starts at -1, so 0 means 1 interrupt outstanding. If we go
|
|
// to >1 then we have interrupts queued and must wait until the current
|
|
// one is dismissed
|
|
//
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("IssueHardwareInterrupt: ENTERING HardwareIntCritSec\n");
|
|
}
|
|
|
|
EnterCriticalSection(&HardwareIntCritSec);
|
|
++HardwareIntsQueued;
|
|
if (!HardwareIntsQueued) {
|
|
VrQueueCompletionHandler(VrDlcHwInterrupt);
|
|
//call_ica_hw_interrupt(NETWORK_ICA, NETWORK_LINE, 1);
|
|
VrRaiseInterrupt();
|
|
} else {
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** INT Queued (%d) ***\n", HardwareIntsQueued));
|
|
}
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("IssueHardwareInterrupt: LEAVING HardwareIntCritSec\n");
|
|
}
|
|
|
|
LeaveCriticalSection(&HardwareIntCritSec);
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("*** EOF INT ***\n");
|
|
}
|
|
}
|
|
|
|
|
|
VOID
|
|
AcknowledgeHardwareInterrupt(
|
|
VOID
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
The companion routine to IssueHardwareInterrupt. Here we just decrement the
|
|
interrupt counter. If it is >= 0 then we still have interrupts pending, so
|
|
we issue a new interrupt request. This seems to work - we don't lose
|
|
interrupt requests to the VDM
|
|
|
|
Arguments:
|
|
|
|
None.
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
#if DBG
|
|
|
|
LONG deferredInts;
|
|
|
|
#endif
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** INT ACK ***\n"));
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT("*** INT ACK ***\n");
|
|
}
|
|
|
|
//
|
|
// decrement the interrupt counter within the critical section. If it goes
|
|
// to -1 then we have no more outstanding hardware interrupt requests. If
|
|
// it is > -1 then issue a new interrupt request
|
|
//
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("AcknowledgeHardwareInterrupt: ENTERING HardwareIntCritSec\n");
|
|
}
|
|
|
|
EnterCriticalSection(&HardwareIntCritSec);
|
|
--HardwareIntsQueued;
|
|
|
|
#if DBG
|
|
|
|
deferredInts = HardwareIntsQueued;
|
|
|
|
#endif
|
|
|
|
//
|
|
// sanity check
|
|
//
|
|
|
|
ASSERT(HardwareIntsQueued >= -1);
|
|
|
|
if (HardwareIntsQueued >= 0) {
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** INT2 ***\n"));
|
|
}
|
|
|
|
VrQueueCompletionHandler(VrDlcHwInterrupt);
|
|
//call_ica_hw_interrupt(NETWORK_ICA, NETWORK_LINE, 1);
|
|
VrRaiseInterrupt();
|
|
}
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("AcknowledgeHardwareInterrupt: LEAVING HardwareIntCritSec\n");
|
|
}
|
|
|
|
LeaveCriticalSection(&HardwareIntCritSec);
|
|
|
|
#if DBG
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** EOF INT ACK (%d) ***\n", deferredInts));
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("*** EOF INT ACK (%d) ***\n", deferredInts);
|
|
}
|
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
|
VOID
|
|
CancelHardwareInterrupts(
|
|
IN LONG Count
|
|
)
|
|
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
Used to decrement the number of pending h/w interrupts. We need to do this
|
|
when removing completed READ CCBs from an event queue for which h/w
|
|
interrupts have been issued
|
|
|
|
Arguments:
|
|
|
|
Count - number of h/w interrupt requests to cancel. Used to aggregate
|
|
the cancels, saving Count-1 calls to this routine & Enter &
|
|
Leave critical section calls
|
|
|
|
Return Value:
|
|
|
|
None.
|
|
|
|
--*/
|
|
|
|
{
|
|
#if DBG
|
|
|
|
LONG deferredInts;
|
|
|
|
#endif
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** CancelHardwareInterrupts(%d) ***\n", Count));
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("*** CancelHardwareInterrupts(%d) ***\n", Count);
|
|
}
|
|
|
|
//
|
|
// decrement the interrupt counter within the critical section. If it goes
|
|
// to -1 then we have no more outstanding hardware interrupt requests. If
|
|
// it is > -1 then issue a new interrupt request
|
|
//
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("CancelHardwareInterrupts: ENTERING HardwareIntCritSec\n");
|
|
}
|
|
|
|
EnterCriticalSection(&HardwareIntCritSec);
|
|
HardwareIntsQueued -= Count;
|
|
|
|
#if DBG
|
|
|
|
deferredInts = HardwareIntsQueued;
|
|
|
|
#endif
|
|
|
|
//
|
|
// sanity check
|
|
//
|
|
|
|
ASSERT(HardwareIntsQueued >= -1);
|
|
|
|
IF_DEBUG(CRITSEC) {
|
|
DPUT("CancelHardwareInterrupts: LEAVING HardwareIntCritSec\n");
|
|
}
|
|
|
|
LeaveCriticalSection(&HardwareIntCritSec);
|
|
|
|
#if DBG
|
|
|
|
IF_DEBUG(CRITICAL) {
|
|
CRITDUMP(("*** EOF CancelHardwareInterrupts (%d) ***\n", deferredInts));
|
|
}
|
|
|
|
IF_DEBUG(DLC_ASYNC) {
|
|
DPUT1("*** EOF CancelHardwareInterrupts (%d) ***\n", deferredInts);
|
|
}
|
|
|
|
#endif
|
|
|
|
}
|