1002 lines
26 KiB
C
1002 lines
26 KiB
C
/*++
|
||
|
||
Copyright (c) 1991 Microsoft Corporation
|
||
Copyright (c) 1991 Nokia Data Systems Ab
|
||
|
||
Module Name:
|
||
|
||
llcobj.c
|
||
|
||
Abstract:
|
||
|
||
The module implements the open and close primitives
|
||
for all data link driver objects.
|
||
|
||
Contents:
|
||
LlcOpenStation
|
||
LlcCloseStation
|
||
CompleteClose
|
||
CancelTransmitCommands
|
||
CancelTransmitsInQueue
|
||
LlcSetDirectOpenOptions
|
||
CompleteObjectDelete
|
||
CompletePendingLlcCommand
|
||
LlcDereferenceObject
|
||
LlcReferenceObject
|
||
LlcGetReceivedLanHeaderLength
|
||
LlcGetEthernetType
|
||
LlcGetCommittedSpace
|
||
|
||
Author:
|
||
|
||
Antti Saarenheimo (o-anttis) 29-MAY-1991
|
||
|
||
Revision History:
|
||
|
||
--*/
|
||
|
||
#if DBG
|
||
#ifndef i386
|
||
#define LLC_PRIVATE_PROTOTYPES
|
||
#endif
|
||
#include "dlc.h" // need DLC_FILE_CONTEXT for memory charged to file handle
|
||
#endif
|
||
|
||
#include <llc.h>
|
||
|
||
static USHORT ObjectSizes[] = {
|
||
sizeof(LLC_STATION_OBJECT), // direct station
|
||
sizeof(LLC_SAP ), // SAP station
|
||
sizeof(LLC_STATION_OBJECT), // group SAP
|
||
(USHORT)(-1), // link station
|
||
sizeof(LLC_STATION_OBJECT) // DIX station
|
||
};
|
||
|
||
|
||
DLC_STATUS
|
||
LlcOpenStation(
|
||
IN PBINDING_CONTEXT pBindingContext,
|
||
IN PVOID hClientHandle,
|
||
IN USHORT ObjectAddress,
|
||
IN UCHAR ObjectType,
|
||
IN USHORT OpenOptions,
|
||
OUT PVOID* phStation
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The primitive opens a LLC SAP exclusively for the upper protocol
|
||
driver. The upper protocol must provide the storage for the
|
||
SAP object. The correct size of the object has been defined in the
|
||
characteristics table of the LLC driver.
|
||
|
||
The first call to a new adapter initializes also the NDIS interface
|
||
and allocates internal data structures for the new adapter.
|
||
|
||
Arguments:
|
||
|
||
pBindingContext - binding context of the llc client
|
||
hClientHandle - The client protocol gets this handle in all indications
|
||
of the SAP
|
||
ObjectAddress - LLC SAP number or dix
|
||
ObjectType - type of the created object
|
||
OpenOptions - various open options set for the new object
|
||
phStation - returned opaque handle
|
||
|
||
Special: Must be called IRQL < DPC (at least when direct station opened)
|
||
|
||
Return Value:
|
||
|
||
DLC_STATUS
|
||
Success - STATUS_SUCCESS
|
||
Failure - DLC_STATUS_NO_MEMORY
|
||
DLC_STATUS_INVALID_SAP_VALUE
|
||
DLC_STATUS_INVALID_OPTION
|
||
DLC_STATUS_INVALID_STATION_ID
|
||
|
||
--*/
|
||
|
||
{
|
||
PADAPTER_CONTEXT pAdapterContext;
|
||
PLLC_OBJECT pStation;
|
||
DLC_STATUS LlcStatus = STATUS_SUCCESS;
|
||
PVOID* ppListBase;
|
||
ULONG PacketFilter;
|
||
|
||
#if DBG
|
||
PDLC_FILE_CONTEXT pFileContext = (PDLC_FILE_CONTEXT)(pBindingContext->hClientContext);
|
||
#endif
|
||
|
||
pAdapterContext = pBindingContext->pAdapterContext;
|
||
|
||
//
|
||
// Allocate and initialize the SAP, but do not yet connect
|
||
// it to the adapter
|
||
//
|
||
|
||
ASSERT(ObjectSizes[ObjectType] != (USHORT)(-1));
|
||
|
||
pStation = (PLLC_OBJECT)ALLOCATE_ZEROMEMORY_FILE(ObjectSizes[ObjectType]);
|
||
|
||
if (pStation == NULL) {
|
||
return DLC_STATUS_NO_MEMORY;
|
||
}
|
||
if (ObjectType == LLC_SAP_OBJECT && (ObjectAddress & 1)) {
|
||
ObjectType = LLC_GROUP_SAP_OBJECT;
|
||
ASSERT(phStation);
|
||
}
|
||
|
||
pStation->Gen.hClientHandle = hClientHandle;
|
||
pStation->Gen.pLlcBinding = pBindingContext;
|
||
pStation->Gen.pAdapterContext = pAdapterContext;
|
||
pStation->Gen.ObjectType = (UCHAR)ObjectType;
|
||
|
||
//
|
||
// The LLC objects must be referenced whenever they should be kept alive
|
||
// over a long operation, that opens the spin locks (especially async
|
||
// operations)
|
||
// The first reference is for open/close
|
||
//
|
||
|
||
ReferenceObject(pStation);
|
||
|
||
//
|
||
// These values are common for SAP, direct (and DIX objects)
|
||
//
|
||
|
||
pStation->Sap.OpenOptions = OpenOptions;
|
||
pStation->Dix.ObjectAddress = ObjectAddress;
|
||
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
switch (pStation->Gen.ObjectType) {
|
||
case LLC_SAP_OBJECT:
|
||
|
||
//
|
||
// RLF 05/13/93
|
||
//
|
||
// don't allow multiple applications to open the same SAP. This is
|
||
// incompatible with OS/2 DLC
|
||
//
|
||
|
||
if (pAdapterContext->apSapBindings[ObjectAddress] == NULL) {
|
||
ppListBase = (PVOID*)&(pAdapterContext->apSapBindings[ObjectAddress]);
|
||
LlcMemCpy(&pStation->Sap.DefaultParameters,
|
||
&DefaultParameters,
|
||
sizeof(DefaultParameters)
|
||
);
|
||
|
||
ALLOCATE_SPIN_LOCK(&pStation->Sap.FlowControlLock);
|
||
|
||
} else {
|
||
|
||
FREE_MEMORY_FILE(pStation);
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
return DLC_STATUS_INVALID_SAP_VALUE;
|
||
}
|
||
break;
|
||
|
||
case LLC_GROUP_SAP_OBJECT:
|
||
ppListBase = (PVOID*)&(pAdapterContext->apSapBindings[ObjectAddress]);
|
||
|
||
//
|
||
// All members of the same group/individual SAP muust have set
|
||
// the same XID handling option
|
||
//
|
||
|
||
if (pAdapterContext->apSapBindings[ObjectAddress] != NULL) {
|
||
if ((OpenOptions & LLC_EXCLUSIVE_ACCESS)
|
||
|| (pAdapterContext->apSapBindings[ObjectAddress]->OpenOptions
|
||
& LLC_EXCLUSIVE_ACCESS)) {
|
||
LlcStatus = DLC_STATUS_INVALID_SAP_VALUE;
|
||
} else if ((pAdapterContext->apSapBindings[ObjectAddress]->OpenOptions &
|
||
LLC_HANDLE_XID_COMMANDS) != (OpenOptions & LLC_HANDLE_XID_COMMANDS)) {
|
||
LlcStatus = DLC_STATUS_INVALID_OPTION;
|
||
}
|
||
}
|
||
|
||
ALLOCATE_SPIN_LOCK(&pStation->Sap.FlowControlLock);
|
||
|
||
break;
|
||
|
||
case LLC_DIRECT_OBJECT:
|
||
ppListBase = (PVOID*)&pAdapterContext->pDirectStation;
|
||
break;
|
||
|
||
case LLC_DIX_OBJECT:
|
||
if (pAdapterContext->NdisMedium != NdisMedium802_3) {
|
||
LlcStatus = DLC_STATUS_INVALID_STATION_ID;
|
||
} else {
|
||
ppListBase = (PVOID*)&(pAdapterContext->aDixStations[ObjectAddress % MAX_DIX_TABLE]);
|
||
}
|
||
break;
|
||
|
||
#if LLC_DBG
|
||
default:
|
||
LlcInvalidObjectType();
|
||
break;
|
||
#endif
|
||
}
|
||
|
||
if (LlcStatus == STATUS_SUCCESS) {
|
||
pStation->Gen.pNext = *ppListBase;
|
||
*phStation = *ppListBase = pStation;
|
||
|
||
pAdapterContext->ObjectCount++;
|
||
} else {
|
||
|
||
FREE_MEMORY_FILE(pStation);
|
||
|
||
}
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
if (LlcStatus == STATUS_SUCCESS
|
||
&& pStation->Gen.ObjectType == LLC_DIRECT_OBJECT
|
||
&& OpenOptions & DLC_RCV_MAC_FRAMES
|
||
&& !(pAdapterContext->OpenOptions & DLC_RCV_MAC_FRAMES)) {
|
||
|
||
//
|
||
// We enable the MAC frames, if they have once been enabled,
|
||
// but they will never be disabled again. The receiving
|
||
// of MAC frames is quite exceptional case, and it is
|
||
// not really worth of it to maintain local and global
|
||
// Ndis flag states just because of it
|
||
//
|
||
|
||
PacketFilter = NDIS_PACKET_TYPE_DIRECTED
|
||
| NDIS_PACKET_TYPE_MULTICAST
|
||
| NDIS_PACKET_TYPE_FUNCTIONAL
|
||
| NDIS_PACKET_TYPE_MAC_FRAME;
|
||
|
||
pAdapterContext->OpenOptions |= DLC_RCV_MAC_FRAMES;
|
||
LlcStatus = SetNdisParameter(pAdapterContext,
|
||
OID_GEN_CURRENT_PACKET_FILTER,
|
||
&PacketFilter,
|
||
sizeof(PacketFilter)
|
||
);
|
||
}
|
||
return LlcStatus;
|
||
}
|
||
|
||
|
||
DLC_STATUS
|
||
LlcCloseStation(
|
||
IN PLLC_OBJECT pStation,
|
||
IN PLLC_PACKET pCompletionPacket
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The primitive closes a direct, sap or link station object.
|
||
All pending transmit commands are terminated.
|
||
This primitive does not support graceful termination, but
|
||
the upper level must wait the pending transmit commands, if
|
||
it want to make a clean close (without deleting the transmit queue).
|
||
|
||
For a link station this primitive releases a disconnected link
|
||
station or discards a remote connection request.
|
||
|
||
Arguments:
|
||
|
||
pStation - handle of a link, sap or direct station
|
||
pCompletionPacket - returned context, when the command is complete
|
||
|
||
Return Value:
|
||
|
||
DLC_STATUS
|
||
Success - STATUS_SUCCESS
|
||
Failure - DLC_STATUS_INVALID_PARAMETERS
|
||
the SAP has still active link stations. All active link
|
||
stations must be closed before sap can be closed.
|
||
|
||
--*/
|
||
|
||
{
|
||
PADAPTER_CONTEXT pAdapterContext = pStation->Gen.pAdapterContext;
|
||
PBINDING_CONTEXT pOldBinding;
|
||
PDATA_LINK* ppLink;
|
||
PVOID* ppLinkListBase;
|
||
PEVENT_PACKET pEvent;
|
||
|
||
if (pStation->Gen.ObjectType == LLC_LINK_OBJECT) {
|
||
|
||
//
|
||
// The remote connection requests are routed through all
|
||
// SAP station reqistered on a SAP until someone accepts
|
||
// the connection request or it has been routed to all
|
||
// clients having opened the sap station.
|
||
//
|
||
|
||
if (pStation->Link.Flags & DLC_ACTIVE_REMOTE_CONNECT_REQUEST) {
|
||
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
pOldBinding = pStation->Gen.pLlcBinding;
|
||
if (pStation->Link.pSap->Gen.pNext != NULL) {
|
||
pStation->Gen.pLlcBinding = pStation->Link.pSap->Gen.pNext->Gen.pLlcBinding;
|
||
}
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
//
|
||
// Complete the close command immediately, if
|
||
// the connect request was redirected to another
|
||
// SAP station
|
||
//
|
||
|
||
if (pStation->Gen.pLlcBinding != pOldBinding) {
|
||
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
|
||
pEvent = ALLOCATE_PACKET_LLC_PKT(pAdapterContext->hPacketPool);
|
||
|
||
if (pEvent != NULL) {
|
||
LlcInsertTailList(&pAdapterContext->QueueEvents, pEvent);
|
||
pEvent->pBinding = pStation->Gen.pLlcBinding;
|
||
pEvent->hClientHandle = pStation->Link.pSap->Gen.hClientHandle;
|
||
pEvent->Event = LLC_STATUS_CHANGE_ON_SAP;
|
||
pEvent->pEventInformation = &pStation->Link.DlcStatus;
|
||
pEvent->SecondaryInfo = INDICATE_CONNECT_REQUEST;
|
||
}
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
|
||
if (pEvent != NULL) {
|
||
return STATUS_SUCCESS;
|
||
}
|
||
} else {
|
||
|
||
//
|
||
// Nobody accepted this connect request, we must discard it.
|
||
//
|
||
|
||
RunInterlockedStateMachineCommand((PDATA_LINK)pStation, SET_ADM);
|
||
}
|
||
}
|
||
}
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
|
||
DLC_TRACE('C');
|
||
|
||
switch (pStation->Gen.ObjectType) {
|
||
case LLC_DIRECT_OBJECT:
|
||
|
||
//
|
||
// This Direct must be in the linked list of Directs (having
|
||
// the same source Direct).
|
||
//
|
||
|
||
ppLinkListBase = (PVOID*)&pAdapterContext->pDirectStation;
|
||
|
||
DLC_TRACE('b');
|
||
break;
|
||
|
||
case LLC_DIX_OBJECT:
|
||
|
||
//
|
||
// This Direct must be in the linked list of Directs (having
|
||
// the same source Direct).
|
||
//
|
||
|
||
ppLinkListBase = (PVOID*)&pAdapterContext->aDixStations[pStation->Dix.ObjectAddress % MAX_DIX_TABLE];
|
||
DLC_TRACE('a');
|
||
break;
|
||
|
||
case LLC_SAP_OBJECT:
|
||
|
||
#if LLC_DBG
|
||
if (pStation->Sap.pActiveLinks != NULL) {
|
||
DbgPrint("Closing SAP before link stations!!!\n");
|
||
DbgBreakPoint();
|
||
|
||
//
|
||
// Open the spin locks and return thge error status
|
||
//
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
return DLC_STATUS_LINK_STATIONS_OPEN;
|
||
}
|
||
#endif
|
||
|
||
DLC_TRACE('d');
|
||
|
||
case LLC_GROUP_SAP_OBJECT:
|
||
|
||
//
|
||
// This SAP must be in the linked list of SAPs (having
|
||
// the same source SAP).
|
||
//
|
||
|
||
ppLinkListBase = (PVOID*)&pAdapterContext->apSapBindings[pStation->Sap.SourceSap];
|
||
|
||
DEALLOCATE_SPIN_LOCK(&pStation->Sap.FlowControlLock);
|
||
|
||
break;
|
||
|
||
case LLC_LINK_OBJECT:
|
||
|
||
//
|
||
// Only a disconnected link station can be deactivated.
|
||
// If this fails, then we must disconnect the link station,
|
||
// if it is not already disconnected.
|
||
//
|
||
|
||
if (RunStateMachineCommand((PDATA_LINK)pStation, DEACTIVATE_LS) != STATUS_SUCCESS
|
||
&& pStation->Link.State != DISCONNECTING) {
|
||
|
||
//
|
||
// We must disconnect the link station immediately.
|
||
// We don't care if we are at the moment in
|
||
// a checkpoint state, that would delay the disconnection
|
||
// until the other side has acknowledged it.
|
||
// The link station must be killed now!
|
||
//
|
||
|
||
SendLlcFrame((PDATA_LINK)pStation, DLC_DISC_TOKEN | 1);
|
||
DisableSendProcess((PDATA_LINK)pStation);
|
||
}
|
||
pStation->Link.State = LINK_CLOSED;
|
||
ppLinkListBase = (PVOID *)&pStation->Link.pSap->pActiveLinks;
|
||
ppLink = SearchLinkAddress(pAdapterContext, pStation->Link.LinkAddr);
|
||
*ppLink = pStation->Link.pNextNode;
|
||
|
||
TerminateTimer(pAdapterContext, &pStation->Link.T1);
|
||
TerminateTimer(pAdapterContext, &pStation->Link.T2);
|
||
TerminateTimer(pAdapterContext, &pStation->Link.Ti);
|
||
DLC_TRACE('c');
|
||
break;
|
||
|
||
#if LLC_DBG
|
||
default:
|
||
LlcInvalidObjectType();
|
||
break;
|
||
#endif
|
||
}
|
||
RemoveFromLinkList(ppLinkListBase, pStation);
|
||
|
||
//
|
||
// Queue the asynchronous close command. Group sap and
|
||
// disabling of non-existing link station may use
|
||
// a null packet, because those commands are executed
|
||
// synchronously (they cannot have pending packets)
|
||
//
|
||
|
||
if (pCompletionPacket != NULL) {
|
||
AllocateCompletionPacket(pStation, LLC_CLOSE_COMPLETION, pCompletionPacket);
|
||
}
|
||
|
||
//
|
||
// OK. Everything has been processed =>
|
||
// now we can decrement the object counter.
|
||
//
|
||
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->ObjectDataBase);
|
||
|
||
//
|
||
// Delete the object NOW, if this was the last reference to it
|
||
//
|
||
|
||
LlcDereferenceObject(pStation);
|
||
|
||
return STATUS_PENDING;
|
||
}
|
||
|
||
|
||
VOID
|
||
CompleteClose(
|
||
IN PLLC_OBJECT pLlcObject,
|
||
IN UINT CancelStatus
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Procedure cancel all pending commands of llc object and
|
||
deletes the object.
|
||
The procedure returns a pending status as far the object
|
||
has pending transmits in NDIS.
|
||
|
||
Arguments:
|
||
|
||
pLlcObject - LLC object
|
||
CancelStatus - the status returned in the cancelled (completed) commands
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
PADAPTER_CONTEXT pAdapterContext = pLlcObject->Gen.pAdapterContext;
|
||
UINT Status;
|
||
|
||
#if DBG
|
||
PDLC_FILE_CONTEXT pFileContext = (PDLC_FILE_CONTEXT)(pLlcObject->Gen.pLlcBinding->hClientContext);
|
||
#endif
|
||
|
||
if (pLlcObject->Gen.ReferenceCount != 0) {
|
||
return;
|
||
}
|
||
|
||
//
|
||
// Cancel the queue transmit commands
|
||
//
|
||
|
||
CancelTransmitCommands(pLlcObject, CancelStatus);
|
||
|
||
//
|
||
// Queue also all commands queued in the link stations
|
||
// (actually only LlcConnect and LlcDisconnect),
|
||
// Note: the queue command eats the list of completion packets.
|
||
//
|
||
|
||
while (pLlcObject->Gen.pCompletionPackets != NULL) {
|
||
Status = CancelStatus;
|
||
if (pLlcObject->Gen.pCompletionPackets->Data.Completion.CompletedCommand == LLC_CLOSE_COMPLETION) {
|
||
Status = STATUS_SUCCESS;
|
||
}
|
||
QueueCommandCompletion(pLlcObject,
|
||
(UINT)pLlcObject->Gen.pCompletionPackets->Data.Completion.CompletedCommand,
|
||
Status
|
||
);
|
||
}
|
||
|
||
//
|
||
// release link station specific resources
|
||
//
|
||
|
||
if (pLlcObject->Gen.ObjectType == LLC_LINK_OBJECT) {
|
||
|
||
//
|
||
// The link may have been closed because of an error
|
||
// or timeout (eg. somebody has turned the power off in the
|
||
// other side). We must complete all pending transmits with
|
||
// an error. We assume, that the link has not any more
|
||
// any packets in NDIS queues, but is does not matter,
|
||
// because NDIS packets of a link station will never be
|
||
// directly indicated to the user (they may not exist any
|
||
// more). Thus nothing fatal can happen, if we simply
|
||
// complete all packets and return them to the main
|
||
// packet storage.
|
||
//
|
||
|
||
DEALLOCATE_PACKET_LLC_LNK(pAdapterContext->hLinkPool, pLlcObject);
|
||
|
||
} else {
|
||
|
||
FREE_MEMORY_FILE(pLlcObject);
|
||
|
||
}
|
||
pAdapterContext->ObjectCount--;
|
||
}
|
||
|
||
|
||
VOID
|
||
CancelTransmitCommands(
|
||
IN PLLC_OBJECT pLlcObject,
|
||
IN UINT Status
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Procedure removes the transmit commands of the given LLC client
|
||
from the transmit queue. This cannot cancel those dir/sap transmit
|
||
already queued in NDIS, but the caller must first wait that the
|
||
object has no commands in the NDIS queue.
|
||
|
||
Arguments:
|
||
|
||
pLlcObject - LLC object
|
||
Status - status to set in cancelled transmit commands
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
PADAPTER_CONTEXT pAdapterContext = pLlcObject->Gen.pAdapterContext;
|
||
|
||
//
|
||
// We can (and must) cancel all pending transmits on a link
|
||
// without any global locks, when the station has first
|
||
// been removed from all global data structures,
|
||
//
|
||
|
||
if (pLlcObject->Gen.ObjectType == LLC_LINK_OBJECT) {
|
||
CancelTransmitsInQueue(pLlcObject,
|
||
Status,
|
||
&((PDATA_LINK)pLlcObject)->SendQueue.ListHead,
|
||
NULL
|
||
);
|
||
CancelTransmitsInQueue(pLlcObject,
|
||
Status,
|
||
&((PDATA_LINK)pLlcObject)->SentQueue,
|
||
NULL
|
||
);
|
||
StopSendProcess(pAdapterContext, (PDATA_LINK)pLlcObject);
|
||
|
||
//
|
||
// We cannot leave any S- commands with a reference to the
|
||
// link lan header.
|
||
//
|
||
|
||
CancelTransmitsInQueue(pLlcObject,
|
||
Status,
|
||
&pAdapterContext->QueueExpidited.ListHead,
|
||
&pAdapterContext->QueueExpidited
|
||
);
|
||
} else {
|
||
CancelTransmitsInQueue(pLlcObject,
|
||
Status,
|
||
&pAdapterContext->QueueDirAndU.ListHead,
|
||
&pAdapterContext->QueueDirAndU
|
||
);
|
||
}
|
||
}
|
||
|
||
|
||
VOID
|
||
CancelTransmitsInQueue(
|
||
IN PLLC_OBJECT pLlcObject,
|
||
IN UINT Status,
|
||
IN PLIST_ENTRY pQueue,
|
||
IN PLLC_QUEUE pLlcQueue OPTIONAL
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Procedure removes the transmit commands of the given LLC client
|
||
from the transmit queue. This cannot cancel those dir/sap transmit
|
||
already queued in NDIS, but the caller must first wait that the
|
||
object has no commands in the NDIS queue.
|
||
|
||
Arguments:
|
||
|
||
pLlcObject - LLC object
|
||
Status - the status returned by the completed transmit commands
|
||
pQueue - a data links transmit queue
|
||
pLlcQueue - an optional LLC queue, that is disconnected from the send
|
||
task if the subqueue becomes empty.
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
PLLC_PACKET pPacket;
|
||
PLLC_PACKET pNextPacket;
|
||
PADAPTER_CONTEXT pAdapterContext = pLlcObject->Gen.pAdapterContext;
|
||
|
||
//
|
||
// Cancel all pending transmit commands in LLC queues,
|
||
// check first, if the transmit queue is empty.
|
||
//
|
||
|
||
if (IsListEmpty(pQueue)) {
|
||
return;
|
||
}
|
||
|
||
for (pPacket = (PLLC_PACKET)pQueue->Flink; pPacket != (PLLC_PACKET)pQueue; pPacket = pNextPacket) {
|
||
pNextPacket = pPacket->pNext;
|
||
|
||
//
|
||
// Complete the packet only if it has a correct binding handle
|
||
// and it belongs the given client object. Note: if binding
|
||
// handle is null, then client object handle may be garbage!
|
||
//
|
||
|
||
if (pPacket->CompletionType > LLC_MAX_RESPONSE_PACKET
|
||
&& pPacket->Data.Xmit.pLlcObject == pLlcObject) {
|
||
LlcRemoveEntryList(pPacket);
|
||
|
||
//
|
||
// We MUST NOT cancel those transmit commands, that are
|
||
// still in the NDIS queue!!!! The command completion would
|
||
// make the MDLs in NDIS packet invalid => system would crash.
|
||
//
|
||
|
||
if (((pPacket->CompletionType) & LLC_I_PACKET_PENDING_NDIS) == 0) {
|
||
if (pPacket->pBinding != NULL) {
|
||
LlcInsertTailList(&pAdapterContext->QueueCommands, pPacket);
|
||
pPacket->Data.Completion.CompletedCommand = LLC_SEND_COMPLETION;
|
||
pPacket->Data.Completion.Status = Status;
|
||
pPacket->Data.Completion.hClientHandle = pLlcObject->Gen.hClientHandle;
|
||
} else {
|
||
|
||
DEALLOCATE_PACKET_LLC_PKT(pAdapterContext->hPacketPool, pPacket);
|
||
|
||
}
|
||
} else {
|
||
|
||
//
|
||
// The I-frames must be discarded by the link protocol, because
|
||
// the link is now dead, and we will complete them immediately
|
||
// when NdisSend the completes.
|
||
//
|
||
|
||
pPacket->CompletionType &= ~LLC_I_PACKET_UNACKNOWLEDGED;
|
||
pPacket->Data.Completion.CompletedCommand = LLC_SEND_COMPLETION;
|
||
pPacket->Data.Completion.Status = Status;
|
||
pPacket->Data.Completion.hClientHandle = pLlcObject->Gen.hClientHandle;
|
||
}
|
||
}
|
||
}
|
||
|
||
//
|
||
// Disconnect the list from the send task, if is now empty,
|
||
// We don't use this check with the I- frame queues
|
||
// (StopSendProcess does the same thing for them).
|
||
//
|
||
|
||
if (pLlcQueue != NULL
|
||
&& IsListEmpty(&pLlcQueue->ListHead)
|
||
&& pLlcQueue->ListEntry.Flink != NULL) {
|
||
LlcRemoveEntryList(&pLlcQueue->ListEntry);
|
||
pLlcQueue->ListEntry.Flink = NULL;
|
||
}
|
||
}
|
||
|
||
|
||
//
|
||
// Procedure sets new open options (receive mask) for a direct station.
|
||
// The MAC frames must have been enabled, when the direct
|
||
// object was opened on data link.
|
||
// This is called whenever DLC receive command is issued for direct station.
|
||
//
|
||
VOID
|
||
LlcSetDirectOpenOptions(
|
||
IN PLLC_OBJECT pDirect,
|
||
IN USHORT OpenOptions
|
||
)
|
||
{
|
||
pDirect->Dir.OpenOptions = OpenOptions;
|
||
}
|
||
|
||
|
||
VOID
|
||
CompleteObjectDelete(
|
||
IN PLLC_OBJECT pStation
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The function completes the delete operation for a llc object.
|
||
|
||
Arguments:
|
||
|
||
pStation - link, sap or direct station handle
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
PADAPTER_CONTEXT pAdapterContext = pStation->Gen.pAdapterContext;
|
||
|
||
ACQUIRE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
|
||
if (pStation->Gen.ReferenceCount == 0) {
|
||
CompletePendingLlcCommand(pStation);
|
||
BackgroundProcessAndUnlock(pAdapterContext);
|
||
} else {
|
||
RELEASE_SPIN_LOCK(&pAdapterContext->SendSpinLock);
|
||
}
|
||
}
|
||
|
||
|
||
VOID
|
||
CompletePendingLlcCommand(
|
||
PLLC_OBJECT pLlcObject
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The routines cleans up all commands and event of a llc object
|
||
from the the data link driver.
|
||
|
||
Arguments:
|
||
|
||
pLlObject - a data link object handle (opeque pointer)
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
//
|
||
// The reference count is zero only if the object is deleted,
|
||
// otherwise this is just a reset for a link station.
|
||
//
|
||
|
||
if (pLlcObject->Gen.ReferenceCount == 0) {
|
||
CompleteClose(pLlcObject, DLC_STATUS_CANCELLED_BY_SYSTEM_ACTION);
|
||
} else {
|
||
CancelTransmitCommands(pLlcObject, DLC_STATUS_LINK_NOT_TRANSMITTING);
|
||
}
|
||
}
|
||
|
||
|
||
VOID
|
||
LlcDereferenceObject(
|
||
IN PVOID pStation
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The function dereferences any LLC object.
|
||
THIS ROUTINE MUST BE CALLED ALL SPIN LOCKS UNLOCKED,
|
||
BECAUSE IT MAY CALL BACK !!!!
|
||
|
||
Arguments:
|
||
|
||
pStation - link, sap or direct station handle
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
if (InterlockedDecrement((PLONG)&(((PLLC_OBJECT)(pStation))->Gen.ReferenceCount)) == 0) {
|
||
CompleteObjectDelete(pStation);
|
||
}
|
||
DLC_TRACE('L');
|
||
DLC_TRACE((UCHAR)((PLLC_OBJECT)pStation)->Gen.ReferenceCount);
|
||
}
|
||
|
||
|
||
VOID
|
||
LlcReferenceObject(
|
||
IN PVOID pStation
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
The function references any LLC object. The non-zero
|
||
reference counter keeps LLC objects alive.
|
||
|
||
Arguments:
|
||
|
||
pStation - link, sap or direct station handle
|
||
|
||
Return Value:
|
||
|
||
None.
|
||
|
||
--*/
|
||
|
||
{
|
||
InterlockedIncrement((PLONG)&(((PLLC_OBJECT)pStation)->Gen.ReferenceCount));
|
||
DLC_TRACE('M');
|
||
DLC_TRACE((UCHAR)((PLLC_OBJECT)pStation)->Gen.ReferenceCount);
|
||
}
|
||
|
||
|
||
#if !DLC_AND_LLC
|
||
|
||
//
|
||
// the following routines can be used as macros if DLC and LLC live in the same
|
||
// driver and the one knows about the other's structures
|
||
//
|
||
|
||
UINT
|
||
LlcGetReceivedLanHeaderLength(
|
||
IN PVOID pBinding
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Returns the length of the LAN header of the frame last received from NDIS.
|
||
The size is 14 for all Ethernet types except direct Ethernet frames, and
|
||
whatever we stored in the RcvLanHeaderLength field of the ADAPTER_CONTEXT
|
||
for Token Ring (can contain source routing)
|
||
|
||
Arguments:
|
||
|
||
pBinding - pointer to BINDING_CONTEXT structure describing adapter
|
||
on which frame of interest was received
|
||
|
||
Return Value:
|
||
|
||
UINT
|
||
|
||
--*/
|
||
|
||
{
|
||
return (((PBINDING_CONTEXT)pBinding)->pAdapterContext->NdisMedium == NdisMedium802_3)
|
||
? (((PBINDING_CONTEXT)pBinding)->pAdapterContext->FrameType == LLC_DIRECT_ETHERNET_TYPE)
|
||
? 12
|
||
: 14
|
||
: ((PBINDING_CONTEXT)pBinding)->pAdapterContext->RcvLanHeaderLength;
|
||
}
|
||
|
||
|
||
USHORT
|
||
LlcGetEthernetType(
|
||
IN PVOID hContext
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Returns the Ethernet type set in the adapter context
|
||
|
||
Arguments:
|
||
|
||
hContext - handle of/pointer to BINDING_CONTEXT structure
|
||
|
||
Return Value:
|
||
|
||
USHORT
|
||
|
||
--*/
|
||
|
||
{
|
||
return ((PBINDING_CONTEXT)hContext)->pAdapterContext->EthernetType;
|
||
}
|
||
|
||
|
||
UINT
|
||
LlcGetCommittedSpace(
|
||
IN PVOID hLink
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
Returns the amount of committed buffer space
|
||
|
||
Arguments:
|
||
|
||
hLink -
|
||
|
||
Return Value:
|
||
|
||
UINT
|
||
|
||
--*/
|
||
|
||
{
|
||
return ((PDATA_LINK)hLink)->BufferCommitment;
|
||
}
|
||
|
||
#endif
|