ParaNdis5-Driver.c File Reference

#include "ParaNdis5.h"

Include dependency graph for ParaNdis5-Driver.c:

Go to the source code of this file.

Functions
static VOID NTAPI	ParaVirtualNICUnload (IN PDRIVER_OBJECT pDriverObject)
static VOID NTAPI	ParaNdis5_Shutdown (IN NDIS_HANDLE MiniportAdapterContext)
static NDIS_STATUS NTAPI	ParaNdis5_Initialize (OUT PNDIS_STATUS OpenErrorStatus, OUT PUINT SelectedMediumIndex, IN PNDIS_MEDIUM MediumArray, IN UINT MediumArraySize, IN NDIS_HANDLE MiniportAdapterHandle, IN NDIS_HANDLE WrapperConfigurationContext)
static void	OnReceiveStoppedOnReset (VOID *p)
static void	OnSendStoppedOnReset (VOID *p)
VOID	ParaNdis_Suspend (PARANDIS_ADAPTER *pContext)
VOID	ParaNdis_Resume (PARANDIS_ADAPTER *pContext)
static void NTAPI	OnResetWorkItem (NDIS_WORK_ITEM *pWorkItem, PVOID Context)
static NDIS_STATUS NTAPI	ParaNdis5_Reset (OUT PBOOLEAN AddressingReset, IN NDIS_HANDLE MiniportAdapterContext)
static VOID	OnReceiveStopped (VOID *p)
static VOID	OnSendStopped (VOID *p)
static void	WaitHaltEvent (PARANDIS_ADAPTER *pContext, const char *Reason)
static VOID NTAPI	ParaNdis5_Halt (IN NDIS_HANDLE MiniportAdapterContext)
static BOOLEAN NTAPI	ParaNdis5_CheckForHang (IN NDIS_HANDLE MiniportAdapterContext)
static VOID NTAPI	ParaNdis5_MiniportISR (OUT PBOOLEAN InterruptRecognized, OUT PBOOLEAN QueueMiniportHandleInterrupt, IN NDIS_HANDLE MiniportAdapterContext)
VOID NTAPI	ParaNdis5_PnPEventNotify (IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_DEVICE_PNP_EVENT PnPEvent, IN PVOID InformationBuffer, IN ULONG InformationBufferLength)
NDIS_STATUS NTAPI	DriverEntry (PVOID DriverObject, PVOID RegistryPath)

Variables
static NDIS_HANDLE	DriverHandle
static ULONG	gID = 0

Function Documentation

DriverEntry()

NDIS_STATUS NTAPI DriverEntry	(	PVOID	DriverObject,
		PVOID	RegistryPath
	)

Definition at line 383 of file ParaNdis5-Driver.c.

{
    NDIS_STATUS status;
    NDIS_MINIPORT_CHARACTERISTICS chars;
    ParaNdis_DebugInitialize(DriverObject, RegistryPath);
 
    status = NDIS_STATUS_FAILURE;
 
    DEBUG_ENTRY(0);
    _LogOutString(0, __DATE__ " " __TIME__);
 
    NdisMInitializeWrapper(&DriverHandle,
                           DriverObject,
                           RegistryPath,
                           NULL
                           );
 
    if (DriverHandle)
    {
        NdisZeroMemory(&chars, sizeof(chars));
        //NDIS version of the miniport
        chars.MajorNdisVersion          = NDIS_MINIPORT_MAJOR_VERSION;
        chars.MinorNdisVersion          = NDIS_MINIPORT_MINOR_VERSION;
        //Init and destruction
        chars.InitializeHandler         = ParaNdis5_Initialize;
        chars.HaltHandler               = ParaNdis5_Halt;
 
        //Interrupt and DPC handling
        chars.HandleInterruptHandler    = ParaNdis5_HandleDPC;
        chars.ISRHandler                = ParaNdis5_MiniportISR;
 
        //Packet transfer - send path and notification on the send packet
        chars.SendPacketsHandler        = ParaNdis5_SendPackets;
        chars.ReturnPacketHandler       = ParaNdis5_ReturnPacket;
 
        //OID set\get
        chars.SetInformationHandler     = ParaNdis5_SetOID;
        chars.QueryInformationHandler   = ParaNdis5_QueryOID;
 
        //Reset
        chars.ResetHandler              = ParaNdis5_Reset;
        chars.CheckForHangHandler       = ParaNdis5_CheckForHang; //optional
 
        chars.CancelSendPacketsHandler  = ParaNdis5_CancelSendPackets;
        chars.PnPEventNotifyHandler     = ParaNdis5_PnPEventNotify;
        chars.AdapterShutdownHandler    = ParaNdis5_Shutdown;
 
        status = NdisMRegisterMiniport(
            DriverHandle,
            &chars,
            sizeof(chars));
    }
 
    if (status == NDIS_STATUS_SUCCESS)
    {
        NdisMRegisterUnloadHandler(DriverHandle, ParaVirtualNICUnload);
    }
    else if (DriverHandle)
    {
        DPrintf(0, ("NdisMRegisterMiniport failed"));
        NdisTerminateWrapper(DriverHandle, NULL);
    }
    else
    {
        DPrintf(0, ("NdisMInitializeWrapper failed"));
    }
 
    DEBUG_EXIT_STATUS(status ? 0 : 4, status);
    return status;
}

OnReceiveStopped()

static VOID OnReceiveStopped ( VOID *  p )

static

Definition at line 274 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)p;
    DEBUG_ENTRY(0);
    NdisSetEvent(&pContext->HaltEvent);
}

Referenced by ParaNdis5_Halt().

OnReceiveStoppedOnReset()

static void OnReceiveStoppedOnReset ( VOID *  p )

static

Definition at line 173 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)p;
    DEBUG_ENTRY(0);
    NdisSetEvent(&pContext->ResetEvent);
}

Referenced by ParaNdis_Suspend().

OnResetWorkItem()

static void NTAPI OnResetWorkItem ( NDIS_WORK_ITEM *  pWorkItem, PVOID  Context  )

static

Definition at line 216 of file ParaNdis5-Driver.c.

{
    tGeneralWorkItem *pwi = (tGeneralWorkItem *)pWorkItem;
    PARANDIS_ADAPTER *pContext = pwi->pContext;
    DEBUG_ENTRY(0);
 
    pContext->bResetInProgress = TRUE;
    ParaNdis_IndicateConnect(pContext, FALSE, FALSE);
    ParaNdis_Suspend(pContext);
    ParaNdis_Resume(pContext);
    pContext->bResetInProgress = FALSE;
    ParaNdis_ReportLinkStatus(pContext, FALSE);
 
    NdisFreeMemory(pwi, 0, 0);
    ParaNdis_DebugHistory(pContext, hopSysReset, NULL, 0, NDIS_STATUS_SUCCESS, 0);
    NdisMResetComplete(pContext->MiniportHandle, NDIS_STATUS_SUCCESS, TRUE);
}

Referenced by ParaNdis5_Reset().

OnSendStopped()

static VOID OnSendStopped ( VOID *  p )

static

Definition at line 284 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)p;
    DEBUG_ENTRY(0);
    NdisSetEvent(&pContext->HaltEvent);
}

Referenced by ParaNdis5_Halt().

OnSendStoppedOnReset()

static void OnSendStoppedOnReset ( VOID *  p )

static

Definition at line 183 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)p;
    DEBUG_ENTRY(0);
    NdisSetEvent(&pContext->ResetEvent);
}

Referenced by ParaNdis_Suspend().

ParaNdis5_CheckForHang()

static BOOLEAN NTAPI ParaNdis5_CheckForHang ( IN NDIS_HANDLE  MiniportAdapterContext )

static

Definition at line 338 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    DEBUG_ENTRY(8);
    return ParaNdis_CheckForHang(pContext);
}

Referenced by DriverEntry().

ParaNdis5_Halt()

static VOID NTAPI ParaNdis5_Halt ( IN NDIS_HANDLE  MiniportAdapterContext )

static

Definition at line 307 of file ParaNdis5-Driver.c.

{
    NDIS_STATUS status = NDIS_STATUS_SUCCESS;
    BOOLEAN bUnused;
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    DEBUG_ENTRY(0);
 
    ParaNdis_DebugHistory(pContext, hopHalt, NULL, 1, 0, 0);
 
    NdisCancelTimer(&pContext->ConnectTimer, &bUnused);
    NdisResetEvent(&pContext->HaltEvent);
    if (NDIS_STATUS_PENDING != ParaNdis5_StopSend(pContext, TRUE, OnSendStopped))
        NdisSetEvent(&pContext->HaltEvent);
    WaitHaltEvent(pContext, "Send");
    NdisResetEvent(&pContext->HaltEvent);
    if (NDIS_STATUS_PENDING != ParaNdis5_StopReceive(pContext, TRUE, OnReceiveStopped))
        NdisSetEvent(&pContext->HaltEvent);
    WaitHaltEvent(pContext, "Receive");
    ParaNdis_CleanupContext(pContext);
    NdisCancelTimer(&pContext->DPCPostProcessTimer, &bUnused);
    ParaNdis_DebugHistory(pContext, hopHalt, NULL, 0, 0, 0);
    ParaNdis_DebugRegisterMiniport(pContext, FALSE);
    NdisFreeMemory(pContext, 0, 0);
    DEBUG_EXIT_STATUS(0, status);
}

Referenced by DriverEntry().

ParaNdis5_Initialize()

static NDIS_STATUS NTAPI ParaNdis5_Initialize ( OUT PNDIS_STATUS  OpenErrorStatus, OUT PUINT  SelectedMediumIndex, IN PNDIS_MEDIUM  MediumArray, IN UINT  MediumArraySize, IN NDIS_HANDLE  MiniportAdapterHandle, IN NDIS_HANDLE  WrapperConfigurationContext  )

static

Definition at line 68 of file ParaNdis5-Driver.c.

{
    NDIS_STATUS  status = NDIS_STATUS_UNSUPPORTED_MEDIA;
    PARANDIS_ADAPTER *pContext = NULL;
    UINT i;
    for(i = 0; i < MediumArraySize; ++i)
    {
        if(MediumArray[i] == NdisMedium802_3)
        {
            *SelectedMediumIndex = i;
            status = NDIS_STATUS_SUCCESS;
            break;
        }
    }
 
    if (status == NDIS_STATUS_SUCCESS)
    {
        pContext =
            (PARANDIS_ADAPTER *)ParaNdis_AllocateMemory(NULL, sizeof(PARANDIS_ADAPTER));
        if (!pContext)
        {
            status = NDIS_STATUS_RESOURCES;
        }
    }
 
    if (status == NDIS_STATUS_SUCCESS)
    {
        PVOID pResourceList = &status;
        UINT  uSize = 0;
        NdisZeroMemory(pContext, sizeof(PARANDIS_ADAPTER));
        pContext->ulUniqueID = NdisInterlockedIncrement(&gID);
        pContext->DriverHandle = DriverHandle;
        pContext->MiniportHandle = MiniportAdapterHandle;
        pContext->WrapperConfigurationHandle = WrapperConfigurationContext;
        NdisMQueryAdapterResources(&status, WrapperConfigurationContext, pResourceList, &uSize);
        if (uSize > 0)
            pResourceList = ParaNdis_AllocateMemory(MiniportAdapterHandle, uSize);
        else
            pResourceList = NULL;
        if (!pResourceList)
            status = uSize > 0 ? NDIS_STATUS_RESOURCES : NDIS_STATUS_FAILURE;
        else
        {
            ULONG attributes;
            attributes = NDIS_ATTRIBUTE_DESERIALIZE | NDIS_ATTRIBUTE_BUS_MASTER;
            // in XP SP2, if this flag is NOT set, the NDIS halts miniport
            // upon transition to S1..S4.
            // it seems that XP SP3 ignores it and always sends SET_POWER to D3
#ifndef NO_XP_POWER_MANAGEMENT
            attributes |= NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND;
#endif
            NdisMSetAttributesEx(
                MiniportAdapterHandle,
                pContext,
                0,
                attributes,
                NdisInterfacePci);
            NdisMQueryAdapterResources(&status, WrapperConfigurationContext, pResourceList, &uSize);
            status = ParaNdis_InitializeContext(pContext, (PNDIS_RESOURCE_LIST)pResourceList);
            NdisFreeMemory(pResourceList, 0, 0);
        }
    }
 
    if (status == NDIS_STATUS_SUCCESS)
    {
        status = ParaNdis_FinishInitialization(pContext);
        if (status == NDIS_STATUS_SUCCESS)
        {
            ParaNdis_DebugRegisterMiniport(pContext, TRUE);
            ParaNdis_IndicateConnect(pContext, FALSE, TRUE);
            ParaNdis5_StopSend(pContext, FALSE, NULL);
            ParaNdis5_StopReceive(pContext, FALSE, NULL);
            if (!pContext->ulMilliesToConnect)
            {
                ParaNdis_ReportLinkStatus(pContext, FALSE);
            }
            else
            {
                NdisSetTimer(&pContext->ConnectTimer, pContext->ulMilliesToConnect);
            }
        }
        else
        {
            ParaNdis_CleanupContext(pContext);
        }
    }
 
    if (status != NDIS_STATUS_SUCCESS && pContext)
    {
        NdisFreeMemory(pContext, 0, 0);
    }
 
    DEBUG_EXIT_STATUS(0, status);
    return status;
}

Referenced by DriverEntry().

ParaNdis5_MiniportISR()

static VOID NTAPI ParaNdis5_MiniportISR ( OUT PBOOLEAN  InterruptRecognized, OUT PBOOLEAN  QueueMiniportHandleInterrupt, IN NDIS_HANDLE  MiniportAdapterContext  )

static

Definition at line 349 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    BOOLEAN b;
    *QueueMiniportHandleInterrupt = FALSE;
    b = ParaNdis_OnLegacyInterrupt(pContext, QueueMiniportHandleInterrupt);
    *InterruptRecognized = b;
    DEBUG_EXIT_STATUS(7, (ULONG)b);
}

Referenced by DriverEntry().

ParaNdis5_PnPEventNotify()

VOID NTAPI ParaNdis5_PnPEventNotify	(	IN NDIS_HANDLE	MiniportAdapterContext,
		IN NDIS_DEVICE_PNP_EVENT	PnPEvent,
		IN PVOID	InformationBuffer,
		IN ULONG	InformationBufferLength
	)

Definition at line 367 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    ParaNdis_OnPnPEvent(pContext, PnPEvent, InformationBuffer, InformationBufferLength);
}

Referenced by DriverEntry().

ParaNdis5_Reset()

static NDIS_STATUS NTAPI ParaNdis5_Reset ( OUT PBOOLEAN  AddressingReset, IN NDIS_HANDLE  MiniportAdapterContext  )

static

Definition at line 240 of file ParaNdis5-Driver.c.

{
    NDIS_STATUS status;
    tGeneralWorkItem *pwi;
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    DEBUG_ENTRY(0);
    ParaNdis_DebugHistory(pContext, hopSysReset, NULL, 1, 0, 0);
    status = NDIS_STATUS_FAILURE;
    pwi = ParaNdis_AllocateMemory(pContext, sizeof(tGeneralWorkItem));
    if (pwi)
    {
        pwi->pContext = pContext;
        NdisInitializeWorkItem(&pwi->wi, OnResetWorkItem, pwi);
        if (NdisScheduleWorkItem(&pwi->wi) == NDIS_STATUS_SUCCESS)
        {
            status = NDIS_STATUS_PENDING;
        }
        else
        {
            NdisFreeMemory(pwi, 0, 0);
        }
    }
    if (status != NDIS_STATUS_PENDING)
    {
        ParaNdis_DebugHistory(pContext, hopSysReset, NULL, 0, status, 0);
    }
    return status;
}

Referenced by DriverEntry().

ParaNdis5_Shutdown()

static VOID NTAPI ParaNdis5_Shutdown ( IN NDIS_HANDLE  MiniportAdapterContext )

static

Definition at line 55 of file ParaNdis5-Driver.c.

{
    PARANDIS_ADAPTER *pContext = (PARANDIS_ADAPTER *)MiniportAdapterContext;
    ParaNdis_OnShutdown(pContext);
}

Referenced by DriverEntry().

ParaNdis_Resume()

VOID ParaNdis_Resume

(

PARANDIS_ADAPTER *

pContext

)

Definition at line 209 of file ParaNdis5-Driver.c.

{
    ParaNdis5_StopSend(pContext, FALSE, NULL);
    ParaNdis5_StopReceive(pContext, FALSE, NULL);
    DEBUG_EXIT_STATUS(0, 0);
}

Referenced by OnResetWorkItem(), and ParaNdis_PowerOn().

ParaNdis_Suspend()

VOID ParaNdis_Suspend

(

PARANDIS_ADAPTER *

pContext

)

Definition at line 190 of file ParaNdis5-Driver.c.

{
    DEBUG_ENTRY(0);
    NdisResetEvent(&pContext->ResetEvent);
    if (NDIS_STATUS_PENDING != ParaNdis5_StopSend(pContext, TRUE, OnSendStoppedOnReset))
    {
        NdisSetEvent(&pContext->ResetEvent);
    }
    NdisWaitEvent(&pContext->ResetEvent, 0);
    NdisResetEvent(&pContext->ResetEvent);
    if (NDIS_STATUS_PENDING != ParaNdis5_StopReceive(pContext, TRUE, OnReceiveStoppedOnReset))
    {
        NdisSetEvent(&pContext->ResetEvent);
    }
    NdisWaitEvent(&pContext->ResetEvent, 0);
    NdisResetEvent(&pContext->ResetEvent);
    DEBUG_EXIT_STATUS(0, 0);
}

Referenced by OnResetWorkItem(), and ParaNdis_PowerOff().

ParaVirtualNICUnload()

static VOID NTAPI ParaVirtualNICUnload ( IN PDRIVER_OBJECT  pDriverObject )

static

Definition at line 43 of file ParaNdis5-Driver.c.

{
    DEBUG_ENTRY(0);
    ParaNdis_DebugCleanup(pDriverObject);
}

Referenced by DriverEntry().

WaitHaltEvent()

static void WaitHaltEvent ( PARANDIS_ADAPTER *  pContext, const char *  Reason  )

static

Definition at line 291 of file ParaNdis5-Driver.c.

{
    UINT ms = 5000;
    if (!NdisWaitEvent(&pContext->HaltEvent, 1))
    {
        while (!NdisWaitEvent(&pContext->HaltEvent, ms))
        {
            DPrintf(0, ("[%s]", __FUNCTION__));
        }
    }
}

Referenced by ParaNdis5_Halt().

Variable Documentation

DriverHandle

NDIS_HANDLE DriverHandle

static

Definition at line 37 of file ParaNdis5-Driver.c.

Referenced by AcsHlpSendCommand(), DriverEntry(), DriverProc(), IopStartRamdisk(), ParaNdis5_Initialize(), and RxGetRegistryParameters().

gID

ULONG gID = 0

static

Definition at line 38 of file ParaNdis5-Driver.c.

Referenced by ParaNdis5_Initialize().