Source code of Windows XP (NT5)
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.
 
 
 
 
 
 

445 lines
12 KiB

/*++
Copyright (c) 1989, 1990, 1991 Microsoft Corporation
Module Name:
devctx.c
Abstract:
This module contains code which implements the DEVICE_CONTEXT object.
Routines are provided to reference, and dereference transport device
context objects. Currently, there is no need to create them or destroy
them, as this is handled at configuration time. If it is later required
to dynamically load/unload the transport provider's device object and
associated context, then we can add the create and destroy functions.
The transport device context object is a structure which contains a
system-defined DEVICE_OBJECT followed by information which is maintained
by the transport provider, called the context.
Author:
David Beaver (dbeaver) 1 -July 1991
Environment:
Kernel mode
Revision History:
--*/
#include "precomp.h"
#pragma hdrstop
#ifdef ALLOC_PRAGMA
#pragma alloc_text(PAGE,NbfCreateDeviceContext)
#endif
VOID
NbfRefDeviceContext(
IN PDEVICE_CONTEXT DeviceContext
)
/*++
Routine Description:
This routine increments the reference count on a device context.
Arguments:
DeviceContext - Pointer to a transport device context object.
Return Value:
none.
--*/
{
IF_NBFDBG (NBF_DEBUG_DEVCTX) {
NbfPrint0 ("NbfRefDeviceContext: Entered.\n");
}
ASSERT (DeviceContext->ReferenceCount >= 0); // not perfect, but...
(VOID)InterlockedIncrement (&DeviceContext->ReferenceCount);
} /* NbfRefDeviceContext */
VOID
NbfDerefDeviceContext(
IN PDEVICE_CONTEXT DeviceContext
)
/*++
Routine Description:
This routine dereferences a device context by decrementing the
reference count contained in the structure. Currently, we don't
do anything special when the reference count drops to zero, but
we could dynamically unload stuff then.
Arguments:
DeviceContext - Pointer to a transport device context object.
Return Value:
none.
--*/
{
LONG result;
IF_NBFDBG (NBF_DEBUG_DEVCTX) {
NbfPrint0 ("NbfDerefDeviceContext: Entered.\n");
}
result = InterlockedDecrement (&DeviceContext->ReferenceCount);
ASSERT (result >= 0);
if (result == 0) {
NbfDestroyDeviceContext (DeviceContext);
}
} /* NbfDerefDeviceContext */
NTSTATUS
NbfCreateDeviceContext(
IN PDRIVER_OBJECT DriverObject,
IN PUNICODE_STRING DeviceName,
IN OUT PDEVICE_CONTEXT *DeviceContext
)
/*++
Routine Description:
This routine creates and initializes a device context structure.
Arguments:
DriverObject - pointer to the IO subsystem supplied driver object.
DeviceContext - Pointer to a pointer to a transport device context object.
DeviceName - pointer to the name of the device this device object points to.
Return Value:
STATUS_SUCCESS if all is well; STATUS_INSUFFICIENT_RESOURCES otherwise.
--*/
{
NTSTATUS status;
PDEVICE_OBJECT deviceObject;
PDEVICE_CONTEXT deviceContext;
USHORT i;
//
// Create the device object for NETBEUI.
//
status = IoCreateDevice(
DriverObject,
sizeof (DEVICE_CONTEXT) - sizeof (DEVICE_OBJECT) +
(DeviceName->Length + sizeof(UNICODE_NULL)),
DeviceName,
FILE_DEVICE_TRANSPORT,
FILE_DEVICE_SECURE_OPEN,
FALSE,
&deviceObject);
if (!NT_SUCCESS(status)) {
return status;
}
deviceObject->Flags |= DO_DIRECT_IO;
deviceContext = (PDEVICE_CONTEXT)deviceObject;
//
// Initialize our part of the device context.
//
RtlZeroMemory(
((PUCHAR)deviceContext) + sizeof(DEVICE_OBJECT),
sizeof(DEVICE_CONTEXT) - sizeof(DEVICE_OBJECT));
//
// Copy over the device name.
//
deviceContext->DeviceNameLength = DeviceName->Length + sizeof(WCHAR);
deviceContext->DeviceName = (PWCHAR)(deviceContext+1);
RtlCopyMemory(
deviceContext->DeviceName,
DeviceName->Buffer,
DeviceName->Length);
deviceContext->DeviceName[DeviceName->Length/sizeof(WCHAR)] = UNICODE_NULL;
//
// Initialize device context fields.
//
deviceContext->NetmanVariables = NULL; // no variables yet.
//
// Initialize the reference count.
//
deviceContext->ReferenceCount = 1;
#if DBG
{
UINT Counter;
for (Counter = 0; Counter < NUMBER_OF_DCREFS; Counter++) {
deviceContext->RefTypes[Counter] = 0;
}
// This reference is removed by the caller.
deviceContext->RefTypes[DCREF_CREATION] = 1;
}
#endif
deviceContext->CreateRefRemoved = FALSE;
//
// initialize the various fields in the device context
//
InitializeListHead(&deviceContext->Linkage);
KeInitializeSpinLock (&deviceContext->Interlock);
KeInitializeSpinLock (&deviceContext->SpinLock);
KeInitializeSpinLock (&deviceContext->LinkSpinLock);
KeInitializeSpinLock (&deviceContext->TimerSpinLock);
KeInitializeSpinLock (&deviceContext->LoopbackSpinLock);
KeInitializeSpinLock (&deviceContext->SendPoolListLock);
KeInitializeSpinLock (&deviceContext->RcvPoolListLock);
deviceContext->LinkTreeRoot = NULL;
deviceContext->LastLink = NULL;
deviceContext->LinkTreeElements = 0;
deviceContext->LoopbackLinks[0] = NULL;
deviceContext->LoopbackLinks[1] = NULL;
deviceContext->LoopbackInProgress = FALSE;
KeInitializeDpc(
&deviceContext->LoopbackDpc,
NbfProcessLoopbackQueue,
(PVOID)deviceContext
);
deviceContext->WanThreadQueued = FALSE;
ExInitializeWorkItem(
&deviceContext->WanDelayedQueueItem,
NbfProcessWanDelayedQueue,
(PVOID)deviceContext);
deviceContext->UniqueIdentifier = 1;
deviceContext->ControlChannelIdentifier = 1;
InitializeListHead (&deviceContext->ConnectionPool);
InitializeListHead (&deviceContext->AddressPool);
InitializeListHead (&deviceContext->AddressFilePool);
InitializeListHead (&deviceContext->AddressDatabase);
InitializeListHead (&deviceContext->LinkPool);
InitializeListHead (&deviceContext->LinkDeferred);
InitializeListHead (&deviceContext->PacketWaitQueue);
InitializeListHead (&deviceContext->PacketizeQueue);
InitializeListHead (&deviceContext->DataAckQueue);
InitializeListHead (&deviceContext->DeferredRrQueue);
InitializeListHead (&deviceContext->RequestPool);
InitializeListHead (&deviceContext->UIFramePool);
deviceContext->PacketPool.Next = NULL;
deviceContext->RrPacketPool.Next = NULL;
deviceContext->ReceivePacketPool.Next = NULL;
deviceContext->ReceiveBufferPool.Next = NULL;
InitializeListHead (&deviceContext->ReceiveInProgress);
InitializeListHead (&deviceContext->ShortList);
InitializeListHead (&deviceContext->LongList);
InitializeListHead (&deviceContext->PurgeList);
InitializeListHead (&deviceContext->LoopbackQueue);
InitializeListHead (&deviceContext->FindNameQueue);
InitializeListHead (&deviceContext->StatusQueryQueue);
InitializeListHead (&deviceContext->IrpCompletionQueue);
InitializeListHead (&deviceContext->QueryIndicationQueue);
InitializeListHead (&deviceContext->DatagramIndicationQueue);
deviceContext->IndicationQueuesInUse = FALSE;
//
// Equivalent to setting ShortListActive, DataAckQueueActive,
// and LinkDeferredActive to FALSE.
//
deviceContext->a.AnyActive = 0;
deviceContext->ProcessingShortTimer = FALSE;
deviceContext->DataAckQueueChanged = FALSE;
deviceContext->StalledConnectionCount = (USHORT)0;
deviceContext->EasilyDisconnected = FALSE;
//
// Initialize provider statistics.
//
deviceContext->Statistics.Version = 0x0100;
#if 0
deviceContext->Information.Version = 2;
deviceContext->Information.MaxTsduSize = NBF_MAX_TSDU_SIZE;
deviceContext->Information.MaxDatagramSize = NBF_MAX_DATAGRAM_SIZE;
deviceContext->Information.MaxConnectionUserData = NBF_MAX_CONNECTION_USER_DATA;
deviceContext->Information.ServiceFlags = NBF_SERVICE_FLAGS;
deviceContext->Information.TransmittedTsdus = 0;
deviceContext->Information.ReceivedTsdus = 0;
deviceContext->Information.TransmissionErrors = 0;
deviceContext->Information.ReceiveErrors = 0;
deviceContext->Information.MinimumLookaheadData = NBF_MIN_LOOKAHEAD_DATA;
deviceContext->Information.MaximumLookaheadData = NBF_MAX_LOOKAHEAD_DATA;
deviceContext->Information.DiscardedFrames = 0;
deviceContext->Information.OversizeTsdusReceived = 0;
deviceContext->Information.UndersizeTsdusReceived = 0;
deviceContext->Information.MulticastTsdusReceived = 0;
deviceContext->Information.BroadcastTsdusReceived = 0;
deviceContext->Information.MulticastTsdusTransmitted = 0;
deviceContext->Information.BroadcastTsdusTransmitted = 0;
deviceContext->Information.SendTimeouts = 0;
deviceContext->Information.ReceiveTimeouts = 0;
deviceContext->Information.ConnectionIndicationsReceived = 0;
deviceContext->Information.ConnectionIndicationsAccepted = 0;
deviceContext->Information.ConnectionsInitiated = 0;
deviceContext->Information.ConnectionsAccepted = 0;
#endif
deviceContext->State = DEVICECONTEXT_STATE_OPENING;
//
// Loopback buffer is not allocated.
//
deviceContext->LookaheadContiguous = NULL;
//
// Initialize the resource that guards address ACLs.
//
ExInitializeResourceLite (&deviceContext->AddressResource);
//
// No LSNs are in use.
//
for (i=0; i<(NETBIOS_SESSION_LIMIT+1); i++) {
deviceContext->LsnTable[i] = 0;
}
deviceContext->NextLsnStart = 1;
//
// No addresses are in use.
//
for (i=0; i<256; i++) {
deviceContext->AddressCounts[i] = 0;
}
//
// No timers in use at present
//
INITIALIZE_TIMER_STATE(deviceContext);
//
// set the netbios multicast address for this network type
//
for (i=0; i<HARDWARE_ADDRESS_LENGTH; i++) {
deviceContext->LocalAddress.Address [i] = 0; // set later
deviceContext->NetBIOSAddress.Address [i] = 0;
}
deviceContext->Type = NBF_DEVICE_CONTEXT_SIGNATURE;
deviceContext->Size = sizeof (DEVICE_CONTEXT);
*DeviceContext = deviceContext;
return STATUS_SUCCESS;
}
VOID
NbfDestroyDeviceContext(
IN PDEVICE_CONTEXT DeviceContext
)
/*++
Routine Description:
This routine destroys a device context structure.
Arguments:
DeviceContext - Pointer to a pointer to a transport device context object.
Return Value:
None.
--*/
{
KIRQL oldIrql;
ACQUIRE_DEVICES_LIST_LOCK();
// Is ref count zero - or did a new rebind happen now
// See rebind happen in NbfReInitializeDeviceContext
if (DeviceContext->ReferenceCount != 0)
{
// A rebind happened while we waited for the lock
RELEASE_DEVICES_LIST_LOCK();
return;
}
// Splice this adapter of the list of device contexts
RemoveEntryList (&DeviceContext->Linkage);
RELEASE_DEVICES_LIST_LOCK();
// Mark the adapter as going away to prevent activity
DeviceContext->State = DEVICECONTEXT_STATE_STOPPING;
// Free the packet pools, etc. and close the adapter.
NbfCloseNdis (DeviceContext);
// Remove all the storage associated with the device.
NbfFreeResources (DeviceContext);
// Cleanup any kernel resources
ExDeleteResourceLite (&DeviceContext->AddressResource);
// Delete device from IO space
IoDeleteDevice ((PDEVICE_OBJECT)DeviceContext);
return;
}