ParaNdis5.h File Reference

#include "ndis56common.h"

Include dependency graph for ParaNdis5.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_tagPowerWorkItem
struct	_tagGeneralWorkItem

Typedefs
typedef struct _tagPowerWorkItem	tPowerWorkItem
typedef struct _tagGeneralWorkItem	tGeneralWorkItem

Functions
NDIS_STATUS NTAPI	ParaNdis5_SetOID (IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_OID Oid, IN PVOID InformationBuffer, IN ULONG InformationBufferLength, OUT PULONG BytesRead, OUT PULONG BytesNeeded)
NDIS_STATUS NTAPI	ParaNdis5_QueryOID (IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_OID Oid, IN PVOID InformationBuffer, IN ULONG InformationBufferLength, OUT PULONG BytesWritten, OUT PULONG BytesNeeded)
VOID NTAPI	ParaNdis5_SendPackets (IN NDIS_HANDLE MiniportAdapterContext, IN PPNDIS_PACKET PacketArray, IN UINT NumberOfPackets)
VOID NTAPI	ParaNdis5_ReturnPacket (IN NDIS_HANDLE MiniportAdapterContext, IN PNDIS_PACKET Packet)
VOID	ParaNdis5_IndicateConnect (PARANDIS_ADAPTER *pContext, BOOLEAN bConnected)
VOID NTAPI	ParaNdis5_CancelSendPackets (IN NDIS_HANDLE MiniportAdapterContext, IN PVOID CancelId)
NDIS_STATUS	ParaNdis5_StopSend (PARANDIS_ADAPTER *pContext, BOOLEAN bStop, ONPAUSECOMPLETEPROC Callback)
NDIS_STATUS	ParaNdis5_StopReceive (PARANDIS_ADAPTER *pContext, BOOLEAN bStop, ONPAUSECOMPLETEPROC Callback)
VOID NTAPI	ParaNdis5_HandleDPC (IN NDIS_HANDLE MiniportAdapterContext)

Typedef Documentation

tGeneralWorkItem

typedef struct _tagGeneralWorkItem tGeneralWorkItem

tPowerWorkItem

typedef struct _tagPowerWorkItem tPowerWorkItem

Function Documentation

ParaNdis5_CancelSendPackets()

VOID NTAPI ParaNdis5_CancelSendPackets	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN PVOID	CancelId
	)

Definition at line 1303 of file ParaNdis5-Impl.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    LIST_ENTRY DoneList, KeepList;
    UINT n = 0;
    tSendEntry *pEntry;
    DEBUG_ENTRY(0);
    InitializeListHead(&DoneList);
    InitializeListHead(&KeepList);
    NdisAcquireSpinLock(&pContext->SendLock);
    while ( !IsListEmpty(&pContext->SendQueue))
    {
        PNDIS_PACKET  Packet;
        pEntry = (tSendEntry *)RemoveHeadList(&pContext->SendQueue);
        Packet = pEntry->packet;
        if (NDIS_GET_PACKET_CANCEL_ID(Packet) == CancelId)
        {
            InsertTailList(&DoneList, &pEntry->list);
            ++n;
        }
        else InsertTailList(&KeepList, &pEntry->list);
    }
    while ( !IsListEmpty(&KeepList))
    {
        pEntry = (tSendEntry *)RemoveHeadList(&KeepList);
        InsertTailList(&pContext->SendQueue, &pEntry->list);
    }
    NdisReleaseSpinLock(&pContext->SendLock);
    while (!IsListEmpty(&DoneList))
    {
        pEntry = (tSendEntry *)RemoveHeadList(&DoneList);
        NDIS_SET_PACKET_STATUS(pEntry->packet, NDIS_STATUS_REQUEST_ABORTED);
        CompletePacket(pContext, pEntry->packet);
        NdisFreeMemory(pEntry, 0, 0);
    }
    DEBUG_EXIT_STATUS(0, n);
}

Referenced by DriverEntry().

ParaNdis5_HandleDPC()

VOID NTAPI ParaNdis5_HandleDPC

(

IN NDIS_HANDLE

MiniportAdapterContext

)

Definition at line 1445 of file ParaNdis5-Impl.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    ULONG requiresProcessing;
    BOOLEAN unused;
    DEBUG_ENTRY(7);
    // we do not need the timer, as DPC will do all the job
    // this is not a problem if the timer procedure is already running,
    // we need to do our job anyway
    NdisCancelTimer(&pContext->DPCPostProcessTimer, &unused);
    requiresProcessing = ParaNdis_DPCWorkBody(pContext, PARANDIS_UNLIMITED_PACKETS_TO_INDICATE);
    if (requiresProcessing)
    {
        // we need to request additional DPC
        InterlockedOr(&pContext->InterruptStatus, requiresProcessing);
        NdisSetTimer(&pContext->DPCPostProcessTimer, 10);
    }
}

Referenced by DriverEntry().

ParaNdis5_IndicateConnect()

VOID ParaNdis5_IndicateConnect	(	PARANDIS_ADAPTER *	pContext,
		BOOLEAN	bConnected
	)

ParaNdis5_QueryOID()

NDIS_STATUS NTAPI ParaNdis5_QueryOID	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN NDIS_OID	Oid,
		IN PVOID	InformationBuffer,
		IN ULONG	InformationBufferLength,
		OUT PULONG	BytesWritten,
		OUT PULONG	BytesNeeded
	)

Definition at line 261 of file ParaNdis5-Oid.c.

{
    NDIS_STATUS  status = NDIS_STATUS_NOT_SUPPORTED;
    tOidWhatToDo Rules;
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    tOidDesc _oid;
    ParaNdis_GetOidSupportRules(Oid, &Rules, OidsDB);
    _oid.ulToDoFlags = Rules.Flags;
    *BytesWritten = 0;
    *BytesNeeded  = 0;
    ParaNdis_DebugHistory(pContext, hopOidRequest, NULL, Oid, 0, 1);
    DPrintf(Rules.nEntryLevel, ("[%s], id 0x%X(%s) of %d", __FUNCTION__,
                Oid,
                Rules.name,
                InformationBufferLength));
    _oid.Oid = Oid;
    _oid.InformationBuffer = InformationBuffer;
    _oid.InformationBufferLength = InformationBufferLength;
    _oid.pBytesNeeded = (PUINT)BytesNeeded;
    _oid.pBytesRead   = (PUINT)BytesWritten;
    _oid.pBytesWritten = (PUINT)BytesWritten;
    if (pContext->bSurprizeRemoved) status = NDIS_STATUS_NOT_ACCEPTED;
    else if (Rules.Flags & ohfQuery) status = ParaNdis_OidQuery(pContext, &_oid);
 
 
    ParaNdis_DebugHistory(pContext, hopOidRequest, NULL, Oid, status, 0);
    DPrintf((status != NDIS_STATUS_SUCCESS) ? Rules.nExitFailLevel : Rules.nExitOKLevel,
        ("[%s] , id 0x%X(%s) (%X), written %d, needed %d",
        __FUNCTION__,
        Rules.oid,
        Rules.name,
        status,
        *BytesWritten,
        *BytesNeeded));
    return status;
 
}

Referenced by DriverEntry().

ParaNdis5_ReturnPacket()

VOID NTAPI ParaNdis5_ReturnPacket	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN PNDIS_PACKET	Packet
	)

Definition at line 1077 of file ParaNdis5-Impl.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    pIONetDescriptor pBufferDescriptor;
    pBufferDescriptor = (pIONetDescriptor) *REF_MINIPORT(Packet);
    DPrintf(4, ("[%s] buffer %p", __FUNCTION__, pBufferDescriptor));
 
    NdisAcquireSpinLock(&pContext->ReceiveLock);
    pContext->ReuseBufferProc(pContext, pBufferDescriptor);
    NdisReleaseSpinLock(&pContext->ReceiveLock);
}

Referenced by DriverEntry().

ParaNdis5_SendPackets()

VOID NTAPI ParaNdis5_SendPackets	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN PPNDIS_PACKET	PacketArray,
		IN UINT	NumberOfPackets
	)

Definition at line 1243 of file ParaNdis5-Impl.c.

{
    UINT i;
    LIST_ENTRY FailedList, DoneList;
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    InitializeListHead(&FailedList);
    InitializeListHead(&DoneList);
    DPrintf(3, ("[%s] %d packets", __FUNCTION__, NumberOfPackets));
    ParaNdis_DebugHistory(pContext, hopSend, NULL, 1, NumberOfPackets, 0);
 
    NdisAcquireSpinLock(&pContext->SendLock);
 
    for (i = 0; i < NumberOfPackets; ++i)
    {
        UINT uPacketLength = 0;
        NdisQueryPacketLength(PacketArray[i], &uPacketLength);
        NDIS_SET_PACKET_STATUS(PacketArray[i], NDIS_STATUS_SUCCESS);
        NdisInterlockedIncrement(&pContext->NetTxPacketsToReturn);
        if (!pContext->bSurprizeRemoved && pContext->bConnected && pContext->SendState == srsEnabled && uPacketLength)
        {
            tSendEntry *pse = PrepareSendEntry(pContext, PacketArray[i], uPacketLength);
            if (!pse)
            {
                NDIS_SET_PACKET_STATUS(PacketArray[i], NDIS_STATUS_FAILURE);
                CompletePacket(pContext, PacketArray[i]);
            }
            else
            {
                UINT nFragments = 0;
                GET_NUMBER_OF_SG_ELEMENTS(PacketArray[i], &nFragments);
                ParaNdis_DebugHistory(pContext, hopSendPacketMapped, PacketArray[i], 0, nFragments, 0);
                InsertTailList(&pContext->SendQueue, &pse->list);
            }
        }
        else
        {
            NDIS_STATUS status = NDIS_STATUS_FAILURE;
            if (pContext->bSurprizeRemoved) status = NDIS_STATUS_NOT_ACCEPTED;
            NDIS_SET_PACKET_STATUS(PacketArray[i], status);
            CompletePacket(pContext, PacketArray[i]);
            DPrintf(1, ("[%s] packet of %d rejected", __FUNCTION__, uPacketLength));
        }
    }
 
    NdisReleaseSpinLock(&pContext->SendLock);
 
    ParaNdis_ProcessTx(pContext, FALSE, FALSE);
}

Referenced by DriverEntry().

ParaNdis5_SetOID()

NDIS_STATUS NTAPI ParaNdis5_SetOID	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN NDIS_OID	Oid,
		IN PVOID	InformationBuffer,
		IN ULONG	InformationBufferLength,
		OUT PULONG	BytesRead,
		OUT PULONG	BytesNeeded
	)

Definition at line 311 of file ParaNdis5-Oid.c.

{
    NDIS_STATUS  status = NDIS_STATUS_NOT_SUPPORTED;
    tOidWhatToDo Rules;
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    tOidDesc _oid;
    ParaNdis_GetOidSupportRules(Oid, &Rules, OidsDB);
    _oid.ulToDoFlags = Rules.Flags;
    *BytesRead = 0;
    *BytesNeeded = 0;
    ParaNdis_DebugHistory(pContext, hopOidRequest, NULL, Oid, 1, 1);
    DPrintf(Rules.nEntryLevel, ("[%s], id 0x%X(%s) of %d", __FUNCTION__,
                Oid,
                Rules.name,
                InformationBufferLength));
    _oid.Oid = Oid;
    _oid.InformationBuffer = InformationBuffer;
    _oid.InformationBufferLength = InformationBufferLength;
    _oid.pBytesNeeded = (PUINT)BytesNeeded;
    _oid.pBytesRead   = (PUINT)BytesRead;
    _oid.pBytesWritten = (PUINT)BytesRead;
    if (pContext->bSurprizeRemoved) status = NDIS_STATUS_NOT_ACCEPTED;
    else if (Rules.Flags & ohfSet)
    {
        if (Rules.OidSetProc) status = Rules.OidSetProc(pContext, &_oid);
        else
        {
            DPrintf(0, ("[%s] ERROR in OID redirection table", __FUNCTION__));
            status = NDIS_STATUS_INVALID_OID;
        }
    }
    ParaNdis_DebugHistory(pContext, hopOidRequest, NULL, Oid, status, 0);
    if  (status != NDIS_STATUS_PENDING)
    {
        DPrintf((status != NDIS_STATUS_SUCCESS) ? Rules.nExitFailLevel : Rules.nExitOKLevel,
            ("[%s] , id 0x%X(%s) (%X), read %d, needed %d", __FUNCTION__,
            Rules.oid, Rules.name, status, *BytesRead, *BytesNeeded));
    }
    return status;
}

Referenced by DriverEntry().

ParaNdis5_StopReceive()

NDIS_STATUS ParaNdis5_StopReceive	(	PARANDIS_ADAPTER *	pContext,
		BOOLEAN	bStop,
		ONPAUSECOMPLETEPROC	Callback
	)

Definition at line 1410 of file ParaNdis5-Impl.c.

{
    NDIS_STATUS status = NDIS_STATUS_SUCCESS;
    if (bStop)
    {
        ParaNdis_DebugHistory(pContext, hopInternalReceivePause, NULL, 1, 0, 0);
        NdisAcquireSpinLock(&pContext->ReceiveLock);
        if (IsListEmpty(&pContext->NetReceiveBuffersWaiting))
        {
            pContext->ReceiveState = srsDisabled;
            ParaNdis_DebugHistory(pContext, hopInternalReceivePause, NULL, 0, 0, 0);
        }
        else
        {
            pContext->ReceiveState = srsPausing;
            pContext->ReceivePauseCompletionProc = Callback;
            status = NDIS_STATUS_PENDING;
        }
        NdisReleaseSpinLock(&pContext->ReceiveLock);
    }
    else
    {
        pContext->ReceiveState = srsEnabled;
        ParaNdis_DebugHistory(pContext, hopInternalReceiveResume, NULL, 0, 0, 0);
    }
    return status;
}

Referenced by ParaNdis5_Halt(), ParaNdis5_Initialize(), ParaNdis_Resume(), and ParaNdis_Suspend().

ParaNdis5_StopSend()

NDIS_STATUS ParaNdis5_StopSend	(	PARANDIS_ADAPTER *	pContext,
		BOOLEAN	bStop,
		ONPAUSECOMPLETEPROC	Callback
	)

Definition at line 1348 of file ParaNdis5-Impl.c.

{
    NDIS_STATUS status = NDIS_STATUS_SUCCESS;
    if (bStop)
    {
        LIST_ENTRY DoneList;
        tSendEntry *pEntry;
        DEBUG_ENTRY(0);
        ParaNdis_DebugHistory(pContext, hopInternalSendPause, NULL, 1, 0, 0);
        InitializeListHead(&DoneList);
        NdisAcquireSpinLock(&pContext->SendLock);
        if (IsListEmpty(&pContext->TxWaitingList))
        {
            pContext->SendState = srsDisabled;
            while (!IsListEmpty(&pContext->SendQueue))
            {
                pEntry = (tSendEntry *)RemoveHeadList(&pContext->SendQueue);
                InsertTailList(&DoneList, &pEntry->list);
            }
            ParaNdis_DebugHistory(pContext, hopInternalSendPause, NULL, 0, 0, 0);
        }
        else
        {
            pContext->SendState = srsPausing;
            pContext->SendPauseCompletionProc = Callback;
            status = NDIS_STATUS_PENDING;
            while (!IsListEmpty(&pContext->SendQueue))
            {
                pEntry = (tSendEntry *)RemoveHeadList(&pContext->SendQueue);
                pEntry->flags |= SEND_ENTRY_FLAG_READY;
                InsertTailList(&pContext->TxWaitingList, &pEntry->list);
            }
        }
 
        NdisReleaseSpinLock(&pContext->SendLock);
        while (!IsListEmpty(&DoneList))
        {
            pEntry = (tSendEntry *)RemoveHeadList(&DoneList);
            NDIS_SET_PACKET_STATUS(pEntry->packet, NDIS_STATUS_REQUEST_ABORTED);
            CompletePacket(pContext, pEntry->packet);
            NdisFreeMemory(pEntry, 0, 0);
        }
    }
    else
    {
        pContext->SendState = srsEnabled;
        ParaNdis_DebugHistory(pContext, hopInternalSendResume, NULL, 0, 0, 0);
    }
    return status;
}

Referenced by ParaNdis5_Halt(), ParaNdis5_Initialize(), ParaNdis_Resume(), and ParaNdis_Suspend().