misc.c File Reference

#include "ndisuio.h"
#include <debug.h>

Include dependency graph for misc.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NDIS_STATUS	AllocateAndChainBuffer (PNDISUIO_ADAPTER_CONTEXT AdapterContext, PNDIS_PACKET Packet, PVOID Buffer, ULONG BufferSize, BOOLEAN Front)
PNDIS_PACKET	CreatePacketFromPoolBuffer (PNDISUIO_ADAPTER_CONTEXT AdapterContext, PVOID Buffer, ULONG BufferSize)
VOID	CleanupAndFreePacket (PNDIS_PACKET Packet, BOOLEAN FreePool)
PNDISUIO_ADAPTER_CONTEXT	FindAdapterContextByName (PNDIS_STRING DeviceName)
VOID	ReferenceAdapterContext (PNDISUIO_ADAPTER_CONTEXT AdapterContext)
VOID	DereferenceAdapterContextWithOpenEntry (PNDISUIO_ADAPTER_CONTEXT AdapterContext, PNDISUIO_OPEN_ENTRY OpenEntry)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 11 of file misc.c.

Function Documentation

AllocateAndChainBuffer()

NDIS_STATUS AllocateAndChainBuffer	(	PNDISUIO_ADAPTER_CONTEXT	AdapterContext,
		PNDIS_PACKET	Packet,
		PVOID	Buffer,
		ULONG	BufferSize,
		BOOLEAN	Front
	)

Definition at line 15 of file misc.c.

{
    NDIS_STATUS Status;
    PNDIS_BUFFER NdisBuffer;
 
    /* Allocate the NDIS buffer mapping the pool */
    NdisAllocateBuffer(&Status,
                       &NdisBuffer,
                       AdapterContext->BufferPoolHandle,
                       Buffer,
                       BufferSize);
    if (Status != NDIS_STATUS_SUCCESS)
    {
        DPRINT1("No free buffer descriptors\n");
        return Status;
    }
 
    if (Front)
    {
        /* Chain the buffer to front */
        NdisChainBufferAtFront(Packet, NdisBuffer);
    }
    else
    {
        /* Chain the buffer to back */
        NdisChainBufferAtBack(Packet, NdisBuffer);
    }
 
    /* Return success */
    return NDIS_STATUS_SUCCESS;
}

Referenced by CreatePacketFromPoolBuffer().

CleanupAndFreePacket()

VOID CleanupAndFreePacket	(	PNDIS_PACKET	Packet,
		BOOLEAN	FreePool
	)

Definition at line 83 of file misc.c.

{
    PNDIS_BUFFER Buffer;
    PVOID Data;
    ULONG Length;
 
    /* Free each buffer and its backing pool memory */
    while (TRUE)
    {
        /* Unchain each buffer */
        NdisUnchainBufferAtFront(Packet, &Buffer);
        if (!Buffer)
            break;
 
        /* Get the backing memory */
        NdisQueryBuffer(Buffer, &Data, &Length);
 
        /* Free the buffer */
        NdisFreeBuffer(Buffer);
 
        if (FreePool)
        {
            /* Free the backing memory */
            ExFreePool(Data);
        }
    }
 
    /* Free the packet descriptor */
    NdisFreePacket(Packet);
}

Referenced by NduDispatchWrite(), and NduReceive().

CreatePacketFromPoolBuffer()

PNDIS_PACKET CreatePacketFromPoolBuffer	(	PNDISUIO_ADAPTER_CONTEXT	AdapterContext,
		PVOID	Buffer,
		ULONG	BufferSize
	)

Definition at line 52 of file misc.c.

{
    PNDIS_PACKET Packet;
    NDIS_STATUS Status;
 
    /* Allocate a packet descriptor */
    NdisAllocatePacket(&Status,
                       &Packet,
                       AdapterContext->PacketPoolHandle);
    if (Status != NDIS_STATUS_SUCCESS)
    {
        DPRINT1("No free packet descriptors\n");
        return NULL;
    }
 
    /* Use the helper to chain the buffer */
    Status = AllocateAndChainBuffer(AdapterContext, Packet,
                                    Buffer, BufferSize, TRUE);
    if (Status != NDIS_STATUS_SUCCESS)
    {
        NdisFreePacket(Packet);
        return NULL;
    }
 
    /* Return the packet */
    return Packet;
}

Referenced by NduDispatchWrite(), and NduReceive().

DereferenceAdapterContextWithOpenEntry()

VOID DereferenceAdapterContextWithOpenEntry	(	PNDISUIO_ADAPTER_CONTEXT	AdapterContext,
		PNDISUIO_OPEN_ENTRY	OpenEntry
	)

Definition at line 149 of file misc.c.

{
    KIRQL OldIrql;
 
    /* Lock the adapter context */
    KeAcquireSpinLock(&AdapterContext->Spinlock, &OldIrql);
 
    /* Decrement the open count */
    AdapterContext->OpenCount--;
 
    /* Cleanup the open entry if we were given one */
    if (OpenEntry != NULL)
    {
        /* Remove the open entry */
        RemoveEntryList(&OpenEntry->ListEntry);
 
        /* Invalidate the FO */
        OpenEntry->FileObject->FsContext = NULL;
        OpenEntry->FileObject->FsContext2 = NULL;
 
        /* Free the open entry */
        ExFreePool(OpenEntry);
    }
 
    /* Release the adapter context lock */
    KeReleaseSpinLock(&AdapterContext->Spinlock, OldIrql);
}

Referenced by NduDispatchClose(), and OpenDeviceReadWrite().

FindAdapterContextByName()

PNDISUIO_ADAPTER_CONTEXT FindAdapterContextByName

(

PNDIS_STRING

DeviceName

)

Definition at line 115 of file misc.c.

{
    KIRQL OldIrql;
    PLIST_ENTRY CurrentEntry;
    PNDISUIO_ADAPTER_CONTEXT AdapterContext;
 
    KeAcquireSpinLock(&GlobalAdapterListLock, &OldIrql);
    CurrentEntry = GlobalAdapterList.Flink;
    while (CurrentEntry != &GlobalAdapterList)
    {
        AdapterContext = CONTAINING_RECORD(CurrentEntry, NDISUIO_ADAPTER_CONTEXT, ListEntry);
 
        /* Check if the device name matches */
        if (RtlEqualUnicodeString(&AdapterContext->DeviceName, DeviceName, TRUE))
        {
            KeReleaseSpinLock(&GlobalAdapterListLock, OldIrql);
            return AdapterContext;
        }
 
        CurrentEntry = CurrentEntry->Flink;
    }
    KeReleaseSpinLock(&GlobalAdapterListLock, OldIrql);
 
    return NULL;
}

Referenced by OpenDeviceReadWrite().

ReferenceAdapterContext()

VOID ReferenceAdapterContext

(

PNDISUIO_ADAPTER_CONTEXT

AdapterContext

)

Definition at line 142 of file misc.c.

{
    /* Increment the open count */
    AdapterContext->OpenCount++;
}

Referenced by OpenDeviceReadWrite().