miniport.h File Reference

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

Go to the source code of this file.

Classes
struct	_HARDWARE_ADDRESS
struct	_NDIS_M_DRIVER_BLOCK
struct	_NDIS_M_DEVICE_BLOCK
struct	_MINIPORT_RESOURCE
struct	_MINIPORT_CONFIGURATION_CONTEXT
struct	_MINIPORT_BUGCHECK_CONTEXT
struct	_MINIPORT_SHARED_MEMORY
struct	_NDIS_WRAPPER_CONTEXT
struct	_LOGICAL_ADAPTER

Macros
#define	MINIPORT_RESOURCE_TYPE_REGISTRY_DATA   0
#define	MINIPORT_RESOURCE_TYPE_MEMORY   1
#define	GET_MINIPORT_DRIVER(Handle)   ((PNDIS_M_DRIVER_BLOCK)Handle)
#define	GET_LOGICAL_ADAPTER(Handle)   ((PLOGICAL_ADAPTER)Handle)

Typedefs
typedef struct _HARDWARE_ADDRESS	HARDWARE_ADDRESS
typedef struct _HARDWARE_ADDRESS *	PHARDWARE_ADDRESS
typedef struct _NDIS_M_DRIVER_BLOCK	NDIS_M_DRIVER_BLOCK
typedef struct _NDIS_M_DRIVER_BLOCK *	PNDIS_M_DRIVER_BLOCK
typedef struct _NDIS_M_DEVICE_BLOCK	NDIS_M_DEVICE_BLOCK
typedef struct _NDIS_M_DEVICE_BLOCK *	PNDIS_M_DEVICE_BLOCK
typedef struct _MINIPORT_RESOURCE	MINIPORT_RESOURCE
typedef struct _MINIPORT_RESOURCE *	PMINIPORT_RESOURCE
typedef struct _MINIPORT_CONFIGURATION_CONTEXT	MINIPORT_CONFIGURATION_CONTEXT
typedef struct _MINIPORT_CONFIGURATION_CONTEXT *	PMINIPORT_CONFIGURATION_CONTEXT
typedef struct _MINIPORT_BUGCHECK_CONTEXT	MINIPORT_BUGCHECK_CONTEXT
typedef struct _MINIPORT_BUGCHECK_CONTEXT *	PMINIPORT_BUGCHECK_CONTEXT
typedef struct _MINIPORT_SHARED_MEMORY	MINIPORT_SHARED_MEMORY
typedef struct _MINIPORT_SHARED_MEMORY *	PMINIPORT_SHARED_MEMORY
typedef struct _NDIS_WRAPPER_CONTEXT	NDIS_WRAPPER_CONTEXT
typedef struct _NDIS_WRAPPER_CONTEXT *	PNDIS_WRAPPER_CONTEXT
typedef struct _LOGICAL_ADAPTER	LOGICAL_ADAPTER
typedef struct _LOGICAL_ADAPTER *	PLOGICAL_ADAPTER

Functions
VOID	MiniIndicateData (PLOGICAL_ADAPTER Adapter, NDIS_HANDLE MacReceiveContext, PVOID HeaderBuffer, UINT HeaderBufferSize, PVOID LookaheadBuffer, UINT LookaheadBufferSize, UINT PacketSize)
BOOLEAN	MiniAdapterHasAddress (PLOGICAL_ADAPTER Adapter, PNDIS_PACKET Packet)
PLOGICAL_ADAPTER	MiniLocateDevice (PNDIS_STRING AdapterName)
NDIS_STATUS	MiniQueryInformation (PLOGICAL_ADAPTER Adapter, NDIS_OID Oid, ULONG Size, PVOID Buffer, PULONG BytesWritten)
VOID FASTCALL	MiniQueueWorkItem (PLOGICAL_ADAPTER Adapter, NDIS_WORK_ITEM_TYPE WorkItemType, PVOID WorkItemContext, BOOLEAN Top)
NDIS_STATUS FASTCALL	MiniDequeueWorkItem (PLOGICAL_ADAPTER Adapter, NDIS_WORK_ITEM_TYPE *WorkItemType, PVOID *WorkItemContext)
NDIS_STATUS	MiniDoRequest (PLOGICAL_ADAPTER Adapter, PNDIS_REQUEST NdisRequest)
BOOLEAN	NdisFindDevice (UINT VendorID, UINT DeviceID, PUINT BusNumber, PUINT SlotNumber)
VOID	NdisStartDevices (VOID)
VOID NTAPI	MiniportWorker (IN PDEVICE_OBJECT DeviceObject, IN PVOID WorkItem)
VOID NTAPI	MiniSendComplete (IN NDIS_HANDLE MiniportAdapterHandle, IN PNDIS_PACKET Packet, IN NDIS_STATUS Status)
BOOLEAN	MiniIsBusy (PLOGICAL_ADAPTER Adapter, NDIS_WORK_ITEM_TYPE Type)
NDIS_STATUS	MiniReset (PLOGICAL_ADAPTER Adapter)
VOID	MiniDoAddressingReset (PLOGICAL_ADAPTER Adapter)
VOID	MiniWorkItemComplete (PLOGICAL_ADAPTER Adapter, NDIS_WORK_ITEM_TYPE WorkItemType)

Variables
LIST_ENTRY	MiniportListHead
KSPIN_LOCK	MiniportListLock
LIST_ENTRY	AdapterListHead
KSPIN_LOCK	AdapterListLock

Macro Definition Documentation

GET_LOGICAL_ADAPTER

#define GET_LOGICAL_ADAPTER

(

Handle

)

((PLOGICAL_ADAPTER)Handle)

Definition at line 101 of file miniport.h.

GET_MINIPORT_DRIVER

#define GET_MINIPORT_DRIVER

(

Handle

)

((PNDIS_M_DRIVER_BLOCK)Handle)

Definition at line 84 of file miniport.h.

MINIPORT_RESOURCE_TYPE_MEMORY

#define MINIPORT_RESOURCE_TYPE_MEMORY   1

Definition at line 42 of file miniport.h.

MINIPORT_RESOURCE_TYPE_REGISTRY_DATA

#define MINIPORT_RESOURCE_TYPE_REGISTRY_DATA   0

Definition at line 41 of file miniport.h.

Typedef Documentation

HARDWARE_ADDRESS

typedef struct _HARDWARE_ADDRESS HARDWARE_ADDRESS

LOGICAL_ADAPTER

typedef struct _LOGICAL_ADAPTER LOGICAL_ADAPTER

MINIPORT_BUGCHECK_CONTEXT

typedef struct _MINIPORT_BUGCHECK_CONTEXT MINIPORT_BUGCHECK_CONTEXT

MINIPORT_CONFIGURATION_CONTEXT

typedef struct _MINIPORT_CONFIGURATION_CONTEXT MINIPORT_CONFIGURATION_CONTEXT

MINIPORT_RESOURCE

typedef struct _MINIPORT_RESOURCE MINIPORT_RESOURCE

MINIPORT_SHARED_MEMORY

typedef struct _MINIPORT_SHARED_MEMORY MINIPORT_SHARED_MEMORY

NDIS_M_DEVICE_BLOCK

typedef struct _NDIS_M_DEVICE_BLOCK NDIS_M_DEVICE_BLOCK

NDIS_M_DRIVER_BLOCK

typedef struct _NDIS_M_DRIVER_BLOCK NDIS_M_DRIVER_BLOCK

NDIS_WRAPPER_CONTEXT

typedef struct _NDIS_WRAPPER_CONTEXT NDIS_WRAPPER_CONTEXT

PHARDWARE_ADDRESS

typedef struct _HARDWARE_ADDRESS * PHARDWARE_ADDRESS

PLOGICAL_ADAPTER

typedef struct _LOGICAL_ADAPTER * PLOGICAL_ADAPTER

PMINIPORT_BUGCHECK_CONTEXT

typedef struct _MINIPORT_BUGCHECK_CONTEXT * PMINIPORT_BUGCHECK_CONTEXT

PMINIPORT_CONFIGURATION_CONTEXT

typedef struct _MINIPORT_CONFIGURATION_CONTEXT * PMINIPORT_CONFIGURATION_CONTEXT

PMINIPORT_RESOURCE

typedef struct _MINIPORT_RESOURCE * PMINIPORT_RESOURCE

PMINIPORT_SHARED_MEMORY

typedef struct _MINIPORT_SHARED_MEMORY * PMINIPORT_SHARED_MEMORY

PNDIS_M_DEVICE_BLOCK

typedef struct _NDIS_M_DEVICE_BLOCK * PNDIS_M_DEVICE_BLOCK

PNDIS_M_DRIVER_BLOCK

typedef struct _NDIS_M_DRIVER_BLOCK * PNDIS_M_DRIVER_BLOCK

PNDIS_WRAPPER_CONTEXT

typedef struct _NDIS_WRAPPER_CONTEXT * PNDIS_WRAPPER_CONTEXT

Function Documentation

MiniAdapterHasAddress()

BOOLEAN MiniAdapterHasAddress	(	PLOGICAL_ADAPTER	Adapter,
		PNDIS_PACKET	Packet
	)

Definition at line 616 of file miniport.c.

{
    UINT Length;
    PUCHAR PacketAddress;
    PUCHAR AdapterAddress;
    PNDIS_BUFFER NdisBuffer;
    UINT BufferLength;
 
    NDIS_DbgPrint(DEBUG_MINIPORT, ("Called.\n"));
 
#if DBG
    if(!Adapter)
    {
        NDIS_DbgPrint(MIN_TRACE, ("Adapter object was null\n"));
        return FALSE;
    }
 
    if(!Packet)
    {
        NDIS_DbgPrint(MIN_TRACE, ("Packet was null\n"));
        return FALSE;
    }
#endif
 
    NdisQueryPacket(Packet, NULL, NULL, &NdisBuffer, NULL);
 
    if (!NdisBuffer)
    {
        NDIS_DbgPrint(MIN_TRACE, ("Packet contains no buffers.\n"));
        return FALSE;
    }
 
    NdisQueryBuffer(NdisBuffer, (PVOID)&PacketAddress, &BufferLength);
 
    /* FIXME: Should handle fragmented packets */
 
    switch (Adapter->NdisMiniportBlock.MediaType)
    {
        case NdisMedium802_3:
            Length = ETH_LENGTH_OF_ADDRESS;
            /* Destination address is the first field */
            break;
 
        default:
            NDIS_DbgPrint(MIN_TRACE, ("Adapter has unsupported media type (0x%X).\n", Adapter->NdisMiniportBlock.MediaType));
            return FALSE;
    }
 
    if (BufferLength < Length)
    {
        NDIS_DbgPrint(MIN_TRACE, ("Buffer is too small.\n"));
        return FALSE;
    }
 
    AdapterAddress = (PUCHAR)&Adapter->Address;
    NDIS_DbgPrint(MAX_TRACE, ("packet address: %x:%x:%x:%x:%x:%x adapter address: %x:%x:%x:%x:%x:%x\n",
                              *(PacketAddress), *(PacketAddress+1), *(PacketAddress+2), *(PacketAddress+3), *(PacketAddress+4), *(PacketAddress+5),
                              *(AdapterAddress), *(AdapterAddress+1), *(AdapterAddress+2), *(AdapterAddress+3), *(AdapterAddress+4), *(AdapterAddress+5)));
 
    return (RtlCompareMemory(PacketAddress, AdapterAddress, Length) == Length);
}

Referenced by ProSend().

MiniDequeueWorkItem()

NDIS_STATUS FASTCALL MiniDequeueWorkItem	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_WORK_ITEM_TYPE *	WorkItemType,
		PVOID *	WorkItemContext
	)

Definition at line 1050 of file miniport.c.

{
    PNDIS_MINIPORT_WORK_ITEM MiniportWorkItem;
    PNDIS_PACKET Packet;
 
    NDIS_DbgPrint(MAX_TRACE, ("Called.\n"));
 
    MiniportWorkItem = Adapter->WorkQueueHead;
 
    if ((Packet = Adapter->NdisMiniportBlock.FirstPendingPacket))
    {
        Adapter->NdisMiniportBlock.FirstPendingPacket = NULL;
 
        *WorkItemType = NdisWorkItemSend;
        *WorkItemContext = Packet;
 
        return NDIS_STATUS_SUCCESS;
    }
    else if (MiniportWorkItem)
    {
        /* safe due to adapter lock held */
        Adapter->WorkQueueHead = (PNDIS_MINIPORT_WORK_ITEM)MiniportWorkItem->Link.Next;
 
        if (MiniportWorkItem == Adapter->WorkQueueTail)
            Adapter->WorkQueueTail = NULL;
 
        *WorkItemType    = MiniportWorkItem->WorkItemType;
        *WorkItemContext = MiniportWorkItem->WorkItemContext;
 
        ExFreePool(MiniportWorkItem);
 
        return NDIS_STATUS_SUCCESS;
    }
    else
    {
        NDIS_DbgPrint(MIN_TRACE, ("No work item to dequeue\n"));
 
        return NDIS_STATUS_FAILURE;
    }
}

Referenced by MiniportWorker().

MiniDoAddressingReset()

VOID MiniDoAddressingReset

(

PLOGICAL_ADAPTER

Adapter

)

Definition at line 888 of file miniport.c.

{
   ULONG BytesRead;
 
   MiniSetInformation(Adapter,
                      OID_GEN_CURRENT_LOOKAHEAD,
                      sizeof(ULONG),
                      &Adapter->NdisMiniportBlock.CurrentLookahead,
                      &BytesRead);
 
   /* FIXME: Set more stuff */
}

Referenced by MiniReset(), and MiniResetComplete().

MiniDoRequest()

NDIS_STATUS MiniDoRequest	(	PLOGICAL_ADAPTER	Adapter,
		PNDIS_REQUEST	NdisRequest
	)

Definition at line 1107 of file miniport.c.

{
    NDIS_STATUS Status;
    KIRQL OldIrql;
    NDIS_DbgPrint(DEBUG_MINIPORT, ("Called.\n"));
 
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
 
    KeAcquireSpinLockAtDpcLevel(&Adapter->NdisMiniportBlock.Lock);
    Adapter->NdisMiniportBlock.PendingRequest = NdisRequest;
    KeReleaseSpinLockFromDpcLevel(&Adapter->NdisMiniportBlock.Lock);
 
    if (!Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.CoRequestHandler)
    {
        switch (NdisRequest->RequestType)
        {
        case NdisRequestQueryInformation:
            Status = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.QueryInformationHandler)(
                Adapter->NdisMiniportBlock.MiniportAdapterContext,
                NdisRequest->DATA.QUERY_INFORMATION.Oid,
                NdisRequest->DATA.QUERY_INFORMATION.InformationBuffer,
                NdisRequest->DATA.QUERY_INFORMATION.InformationBufferLength,
                (PULONG)&NdisRequest->DATA.QUERY_INFORMATION.BytesWritten,
                (PULONG)&NdisRequest->DATA.QUERY_INFORMATION.BytesNeeded);
            break;
 
        case NdisRequestSetInformation:
            Status = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SetInformationHandler)(
                Adapter->NdisMiniportBlock.MiniportAdapterContext,
                NdisRequest->DATA.SET_INFORMATION.Oid,
                NdisRequest->DATA.SET_INFORMATION.InformationBuffer,
                NdisRequest->DATA.SET_INFORMATION.InformationBufferLength,
                (PULONG)&NdisRequest->DATA.SET_INFORMATION.BytesRead,
                (PULONG)&NdisRequest->DATA.SET_INFORMATION.BytesNeeded);
            break;
 
        default:
            NDIS_DbgPrint(MIN_TRACE, ("Bad request type\n"));
            Status = NDIS_STATUS_FAILURE;
        }
    }
    else
    {
        Status = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.CoRequestHandler)(
            Adapter->NdisMiniportBlock.MiniportAdapterContext,
            NULL, /* FIXME */
            NdisRequest);
    }
 
    if (Status != NDIS_STATUS_PENDING) {
        KeAcquireSpinLockAtDpcLevel(&Adapter->NdisMiniportBlock.Lock);
        Adapter->NdisMiniportBlock.PendingRequest = NULL;
        KeReleaseSpinLockFromDpcLevel(&Adapter->NdisMiniportBlock.Lock);
    }
 
    KeLowerIrql(OldIrql);
 
    if (Status != NDIS_STATUS_PENDING) {
        MiniWorkItemComplete(Adapter, NdisWorkItemRequest);
    }
 
    return Status;
}

Referenced by MiniportWorker(), MiniQueryInformation(), MiniSetInformation(), and ProRequest().

MiniIndicateData()

VOID MiniIndicateData	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_HANDLE	MacReceiveContext,
		PVOID	HeaderBuffer,
		UINT	HeaderBufferSize,
		PVOID	LookaheadBuffer,
		UINT	LookaheadBufferSize,
		UINT	PacketSize
	)

Definition at line 175 of file miniport.c.

{
  KIRQL OldIrql;
  PLIST_ENTRY CurrentEntry;
  PADAPTER_BINDING AdapterBinding;
 
  NDIS_DbgPrint(DEBUG_MINIPORT, ("Called. Adapter (0x%X)  HeaderBuffer (0x%X)  "
      "HeaderBufferSize (0x%X)  LookaheadBuffer (0x%X)  LookaheadBufferSize (0x%X).\n",
      Adapter, HeaderBuffer, HeaderBufferSize, LookaheadBuffer, LookaheadBufferSize));
 
#if DBG
  MiniDisplayPacket2(HeaderBuffer, HeaderBufferSize, LookaheadBuffer, LookaheadBufferSize);
#endif
 
  NDIS_DbgPrint(MAX_TRACE, ("acquiring miniport block lock\n"));
  KeAcquireSpinLock(&Adapter->NdisMiniportBlock.Lock, &OldIrql);
    {
      CurrentEntry = Adapter->ProtocolListHead.Flink;
      NDIS_DbgPrint(DEBUG_MINIPORT, ("CurrentEntry = %x\n", CurrentEntry));
 
      if (CurrentEntry == &Adapter->ProtocolListHead)
        {
          NDIS_DbgPrint(MIN_TRACE, ("WARNING: No upper protocol layer.\n"));
        }
 
      while (CurrentEntry != &Adapter->ProtocolListHead)
        {
          AdapterBinding = CONTAINING_RECORD(CurrentEntry, ADAPTER_BINDING, AdapterListEntry);
      NDIS_DbgPrint(DEBUG_MINIPORT, ("AdapterBinding = %x\n", AdapterBinding));
 
      NDIS_DbgPrint
          (MID_TRACE,
           ("XXX (%x) %x %x %x %x %x %x %x XXX\n",
        *AdapterBinding->ProtocolBinding->Chars.ReceiveHandler,
        AdapterBinding->NdisOpenBlock.ProtocolBindingContext,
        MacReceiveContext,
        HeaderBuffer,
        HeaderBufferSize,
        LookaheadBuffer,
        LookaheadBufferSize,
        PacketSize));
 
          /* call the receive handler */
          (*AdapterBinding->ProtocolBinding->Chars.ReceiveHandler)(
              AdapterBinding->NdisOpenBlock.ProtocolBindingContext,
              MacReceiveContext,
              HeaderBuffer,
              HeaderBufferSize,
              LookaheadBuffer,
              LookaheadBufferSize,
              PacketSize);
 
          CurrentEntry = CurrentEntry->Flink;
        }
    }
  KeReleaseSpinLock(&Adapter->NdisMiniportBlock.Lock, OldIrql);
 
  NDIS_DbgPrint(MAX_TRACE, ("Leaving.\n"));
}

Referenced by EthFilterDprIndicateReceive(), and ProIndicatePacket().

MiniIsBusy()

BOOLEAN MiniIsBusy	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_WORK_ITEM_TYPE	Type
	)

Definition at line 142 of file miniport.c.

{
    BOOLEAN Busy = FALSE;
    KIRQL OldIrql;
 
    KeAcquireSpinLock(&Adapter->NdisMiniportBlock.Lock, &OldIrql);
 
    if (MiniGetFirstWorkItem(Adapter, Type))
    {
        Busy = TRUE;
    }
    else if (Type == NdisWorkItemRequest && Adapter->NdisMiniportBlock.PendingRequest)
    {
       Busy = TRUE;
    }
    else if (Type == NdisWorkItemSend && Adapter->NdisMiniportBlock.FirstPendingPacket)
    {
       Busy = TRUE;
    }
    else if (Type == NdisWorkItemResetRequested &&
             Adapter->NdisMiniportBlock.ResetStatus == NDIS_STATUS_PENDING)
    {
       Busy = TRUE;
    }
 
    KeReleaseSpinLock(&Adapter->NdisMiniportBlock.Lock, OldIrql);
 
    return Busy;
}

Referenced by MiniReset(), MiniWorkItemComplete(), ProRequest(), and proSendPacketToMiniport().

MiniLocateDevice()

PLOGICAL_ADAPTER MiniLocateDevice

(

PNDIS_STRING

AdapterName

)

Definition at line 690 of file miniport.c.

{
    KIRQL OldIrql;
    PLIST_ENTRY CurrentEntry;
    PLOGICAL_ADAPTER Adapter = 0;
 
    ASSERT(AdapterName);
 
    NDIS_DbgPrint(DEBUG_MINIPORT, ("Called.\n"));
 
    if(IsListEmpty(&AdapterListHead))
    {
        NDIS_DbgPrint(MIN_TRACE, ("No registered miniports for protocol to bind to\n"));
        return NULL;
    }
 
    NDIS_DbgPrint(DEBUG_MINIPORT, ("AdapterName = %wZ\n", AdapterName));
 
    KeAcquireSpinLock(&AdapterListLock, &OldIrql);
    {
        CurrentEntry = AdapterListHead.Flink;
 
        while (CurrentEntry != &AdapterListHead)
        {
            Adapter = CONTAINING_RECORD(CurrentEntry, LOGICAL_ADAPTER, ListEntry);
 
            ASSERT(Adapter);
 
            NDIS_DbgPrint(DEBUG_MINIPORT, ("Examining adapter 0x%lx\n", Adapter));
 
            /* We're technically not allowed to call this above PASSIVE_LEVEL, but it doesn't break
             * right now and I'd rather use a working API than reimplement it here */
            if (RtlCompareUnicodeString(AdapterName, &Adapter->NdisMiniportBlock.MiniportName, TRUE) == 0)
            {
                break;
            }
 
            Adapter = NULL;
            CurrentEntry = CurrentEntry->Flink;
        }
    }
    KeReleaseSpinLock(&AdapterListLock, OldIrql);
 
    if(Adapter)
    {
        NDIS_DbgPrint(DEBUG_MINIPORT, ("Leaving. Adapter found at 0x%x\n", Adapter));
    }
    else
    {
        NDIS_DbgPrint(MIN_TRACE, ("Leaving (adapter not found for %wZ).\n", AdapterName));
    }
 
    return Adapter;
}

Referenced by ndisBindMiniportsToProtocol(), and NdisOpenAdapter().

MiniportWorker()

VOID NTAPI MiniportWorker	(	IN PDEVICE_OBJECT	DeviceObject,
		IN PVOID	WorkItem
	)

Definition at line 1223 of file miniport.c.

{
  PLOGICAL_ADAPTER Adapter = DeviceObject->DeviceExtension;
  KIRQL OldIrql, RaiseOldIrql;
  NDIS_STATUS NdisStatus;
  PVOID WorkItemContext;
  NDIS_WORK_ITEM_TYPE WorkItemType;
  BOOLEAN AddressingReset;
 
  IoFreeWorkItem((PIO_WORKITEM)Context);
 
  KeAcquireSpinLock(&Adapter->NdisMiniportBlock.Lock, &OldIrql);
 
  NdisStatus =
      MiniDequeueWorkItem
      (Adapter, &WorkItemType, &WorkItemContext);
 
  KeReleaseSpinLock(&Adapter->NdisMiniportBlock.Lock, OldIrql);
 
  if (NdisStatus == NDIS_STATUS_SUCCESS)
    {
      switch (WorkItemType)
        {
          case NdisWorkItemSend:
            /*
             * called by ProSend when protocols want to send packets to the miniport
             */
 
            if(Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SendPacketsHandler)
              {
                if(Adapter->NdisMiniportBlock.Flags & NDIS_ATTRIBUTE_DESERIALIZE)
                {
                    NDIS_DbgPrint(MAX_TRACE, ("Calling miniport's SendPackets handler\n"));
                    (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SendPacketsHandler)(
                     Adapter->NdisMiniportBlock.MiniportAdapterContext, (PPNDIS_PACKET)&WorkItemContext, 1);
                    NdisStatus = NDIS_STATUS_PENDING;
                }
                else
                {
                    /* SendPackets is called at DISPATCH_LEVEL for all serialized miniports */
                    KeRaiseIrql(DISPATCH_LEVEL, &RaiseOldIrql);
                    {
                      NDIS_DbgPrint(MAX_TRACE, ("Calling miniport's SendPackets handler\n"));
                      (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SendPacketsHandler)(
                       Adapter->NdisMiniportBlock.MiniportAdapterContext, (PPNDIS_PACKET)&WorkItemContext, 1);
                    }
                    KeLowerIrql(RaiseOldIrql);
 
                    NdisStatus = NDIS_GET_PACKET_STATUS((PNDIS_PACKET)WorkItemContext);
                    if( NdisStatus == NDIS_STATUS_RESOURCES ) {
                        MiniQueueWorkItem(Adapter, WorkItemType, WorkItemContext, TRUE);
                        break;
                    }
                }
              }
            else
              {
                if(Adapter->NdisMiniportBlock.Flags & NDIS_ATTRIBUTE_DESERIALIZE)
                {
                  NDIS_DbgPrint(MAX_TRACE, ("Calling miniport's Send handler\n"));
                  NdisStatus = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SendHandler)(
                                Adapter->NdisMiniportBlock.MiniportAdapterContext, (PNDIS_PACKET)WorkItemContext,
                                ((PNDIS_PACKET)WorkItemContext)->Private.Flags);
                  NDIS_DbgPrint(MAX_TRACE, ("back from miniport's send handler\n"));
                }
                else
                {
                  /* Send is called at DISPATCH_LEVEL for all serialized miniports */
                  KeRaiseIrql(DISPATCH_LEVEL, &RaiseOldIrql);
                  NDIS_DbgPrint(MAX_TRACE, ("Calling miniport's Send handler\n"));
                  NdisStatus = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.SendHandler)(
                                Adapter->NdisMiniportBlock.MiniportAdapterContext, (PNDIS_PACKET)WorkItemContext,
                                ((PNDIS_PACKET)WorkItemContext)->Private.Flags);
                  NDIS_DbgPrint(MAX_TRACE, ("back from miniport's send handler\n"));
                  KeLowerIrql(RaiseOldIrql);
                  if( NdisStatus == NDIS_STATUS_RESOURCES ) {
                      MiniQueueWorkItem(Adapter, WorkItemType, WorkItemContext, TRUE);
                      break;
                  }
                }
              }
 
        if( NdisStatus != NDIS_STATUS_PENDING ) {
        MiniSendComplete
            ( Adapter, (PNDIS_PACKET)WorkItemContext, NdisStatus );
        }
            break;
 
          case NdisWorkItemSendLoopback:
            /*
             * called by ProSend when protocols want to send loopback packets
             */
            /* XXX atm ProIndicatePacket sends a packet up via the loopback adapter only */
            NdisStatus = ProIndicatePacket(Adapter, (PNDIS_PACKET)WorkItemContext);
 
            if( NdisStatus != NDIS_STATUS_PENDING )
                MiniSendComplete((NDIS_HANDLE)Adapter, (PNDIS_PACKET)WorkItemContext, NdisStatus);
            break;
 
          case NdisWorkItemReturnPackets:
            break;
 
          case NdisWorkItemResetRequested:
            NdisMIndicateStatus(Adapter, NDIS_STATUS_RESET_START, NULL, 0);
            NdisMIndicateStatusComplete(Adapter);
 
            KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
            NdisStatus = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.ResetHandler)(
                          &AddressingReset,
                          Adapter->NdisMiniportBlock.MiniportAdapterContext);
 
            KeAcquireSpinLockAtDpcLevel(&Adapter->NdisMiniportBlock.Lock);
            Adapter->NdisMiniportBlock.ResetStatus = NdisStatus;
            KeReleaseSpinLockFromDpcLevel(&Adapter->NdisMiniportBlock.Lock);
 
            KeLowerIrql(OldIrql);
 
            if (NdisStatus != NDIS_STATUS_PENDING)
               MiniResetComplete(Adapter, NdisStatus, AddressingReset);
            break;
 
          case NdisWorkItemResetInProgress:
            break;
 
          case NdisWorkItemMiniportCallback:
            break;
 
          case NdisWorkItemRequest:
            NdisStatus = MiniDoRequest(Adapter, (PNDIS_REQUEST)WorkItemContext);
 
            if (NdisStatus == NDIS_STATUS_PENDING)
              break;
 
            Adapter->NdisMiniportBlock.PendingRequest = (PNDIS_REQUEST)WorkItemContext;
            switch (((PNDIS_REQUEST)WorkItemContext)->RequestType)
              {
                case NdisRequestQueryInformation:
                  NdisMQueryInformationComplete((NDIS_HANDLE)Adapter, NdisStatus);
                  break;
 
                case NdisRequestSetInformation:
                  NdisMSetInformationComplete((NDIS_HANDLE)Adapter, NdisStatus);
                  break;
 
                default:
                  NDIS_DbgPrint(MIN_TRACE, ("Unknown NDIS request type.\n"));
                  break;
              }
            Adapter->NdisMiniportBlock.PendingRequest = NULL;
            break;
 
          default:
            NDIS_DbgPrint(MIN_TRACE, ("Unknown NDIS work item type (%d).\n", WorkItemType));
            break;
        }
    }
}

Referenced by MiniWorkItemComplete().

MiniQueryInformation()

NDIS_STATUS MiniQueryInformation	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_OID	Oid,
		ULONG	Size,
		PVOID	Buffer,
		PULONG	BytesWritten
	)

Definition at line 805 of file miniport.c.

{
  NDIS_STATUS NdisStatus;
  PNDIS_REQUEST NdisRequest;
  KEVENT Event;
  PNDIS_REQUEST_MAC_BLOCK MacBlock;
 
  NDIS_DbgPrint(DEBUG_MINIPORT, ("Called.\n"));
 
  NdisRequest = ExAllocatePool(NonPagedPool, sizeof(NDIS_REQUEST));
  if (!NdisRequest) {
      NDIS_DbgPrint(MIN_TRACE, ("Insufficient resources\n"));
      return NDIS_STATUS_RESOURCES;
  }
 
  RtlZeroMemory(NdisRequest, sizeof(NDIS_REQUEST));
 
  NdisRequest->RequestType = NdisRequestQueryInformation;
  NdisRequest->DATA.QUERY_INFORMATION.Oid = Oid;
  NdisRequest->DATA.QUERY_INFORMATION.InformationBuffer = Buffer;
  NdisRequest->DATA.QUERY_INFORMATION.InformationBufferLength = Size;
 
  /* We'll need to give the completion routine some way of letting us know
   * when it's finished. We'll stash a pointer to an event in the MacBlock */
  KeInitializeEvent(&Event, NotificationEvent, FALSE);
  MacBlock = (PNDIS_REQUEST_MAC_BLOCK)NdisRequest->MacReserved;
  MacBlock->Unknown1 = &Event;
 
  NdisStatus = MiniDoRequest(Adapter, NdisRequest);
 
  if (NdisStatus == NDIS_STATUS_PENDING)
  {
      KeWaitForSingleObject(&Event, Executive, KernelMode, FALSE, NULL);
      NdisStatus = PtrToUlong(MacBlock->Unknown3);
  }
 
  *BytesWritten = NdisRequest->DATA.QUERY_INFORMATION.BytesWritten;
 
  ExFreePool(NdisRequest);
 
  return NdisStatus;
}

Referenced by DoQueries(), NdisIDeviceIoControl(), and NdisIPnPStartDevice().

MiniQueueWorkItem()

VOID FASTCALL MiniQueueWorkItem	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_WORK_ITEM_TYPE	WorkItemType,
		PVOID	WorkItemContext,
		BOOLEAN	Top
	)

Definition at line 982 of file miniport.c.

{
    PNDIS_MINIPORT_WORK_ITEM MiniportWorkItem;
    KIRQL OldIrql;
 
    NDIS_DbgPrint(MAX_TRACE, ("Called.\n"));
 
    ASSERT(Adapter);
 
    KeAcquireSpinLock(&Adapter->NdisMiniportBlock.Lock, &OldIrql);
    if (Top)
    {
        if (WorkItemType == NdisWorkItemSend)
        {
            NDIS_DbgPrint(MIN_TRACE, ("Requeuing failed packet (%x).\n", WorkItemContext));
            Adapter->NdisMiniportBlock.FirstPendingPacket = WorkItemContext;
        }
        else
        {
            //This should never happen
            ASSERT(FALSE);
        }
    }
    else
    {
        MiniportWorkItem = ExAllocatePool(NonPagedPool, sizeof(NDIS_MINIPORT_WORK_ITEM));
        if (!MiniportWorkItem)
        {
            KeReleaseSpinLock(&Adapter->NdisMiniportBlock.Lock, OldIrql);
            NDIS_DbgPrint(MIN_TRACE, ("Insufficient resources.\n"));
            return;
        }
 
        MiniportWorkItem->WorkItemType    = WorkItemType;
        MiniportWorkItem->WorkItemContext = WorkItemContext;
 
        /* safe due to adapter lock held */
        MiniportWorkItem->Link.Next = NULL;
        if (!Adapter->WorkQueueHead)
        {
            Adapter->WorkQueueHead = MiniportWorkItem;
            Adapter->WorkQueueTail = MiniportWorkItem;
        }
        else
        {
            Adapter->WorkQueueTail->Link.Next = (PSINGLE_LIST_ENTRY)MiniportWorkItem;
            Adapter->WorkQueueTail = MiniportWorkItem;
        }
    }
 
    KeReleaseSpinLock(&Adapter->NdisMiniportBlock.Lock, OldIrql);
}

Referenced by MiniportWorker(), MiniReset(), ProRequest(), ProSend(), and proSendPacketToMiniport().

MiniReset()

NDIS_STATUS MiniReset

(

PLOGICAL_ADAPTER

Adapter

)

Definition at line 902 of file miniport.c.

{
   NDIS_STATUS Status;
   KIRQL OldIrql;
   BOOLEAN AddressingReset = TRUE;
 
   if (MiniIsBusy(Adapter, NdisWorkItemResetRequested)) {
       MiniQueueWorkItem(Adapter, NdisWorkItemResetRequested, NULL, FALSE);
       return NDIS_STATUS_PENDING;
   }
 
   NdisMIndicateStatus(Adapter, NDIS_STATUS_RESET_START, NULL, 0);
   NdisMIndicateStatusComplete(Adapter);
 
   KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
   Status = (*Adapter->NdisMiniportBlock.DriverHandle->MiniportCharacteristics.ResetHandler)(
            &AddressingReset,
            Adapter->NdisMiniportBlock.MiniportAdapterContext);
 
   KeAcquireSpinLockAtDpcLevel(&Adapter->NdisMiniportBlock.Lock);
   Adapter->NdisMiniportBlock.ResetStatus = Status;
   KeReleaseSpinLockFromDpcLevel(&Adapter->NdisMiniportBlock.Lock);
 
   KeLowerIrql(OldIrql);
 
   if (Status != NDIS_STATUS_PENDING) {
       if (AddressingReset)
           MiniDoAddressingReset(Adapter);
 
       NdisMIndicateStatus(Adapter, NDIS_STATUS_RESET_END, NULL, 0);
       NdisMIndicateStatusComplete(Adapter);
 
       MiniWorkItemComplete(Adapter, NdisWorkItemResetRequested);
   }
 
   return Status;
}

Referenced by MiniportHangDpc(), and ProReset().

MiniSendComplete()

VOID NTAPI MiniSendComplete	(	IN NDIS_HANDLE	MiniportAdapterHandle,
		IN PNDIS_PACKET	Packet,
		IN NDIS_STATUS	Status
	)

Definition at line 530 of file miniport.c.

{
    PLOGICAL_ADAPTER Adapter = MiniportAdapterHandle;
    PADAPTER_BINDING AdapterBinding;
    KIRQL OldIrql;
    PSCATTER_GATHER_LIST SGList;
 
    NDIS_DbgPrint(DEBUG_MINIPORT, ("Called.\n"));
 
    AdapterBinding = (PADAPTER_BINDING)Packet->Reserved[1];
 
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
 
    if (Adapter->NdisMiniportBlock.ScatterGatherListSize != 0)
    {
        NDIS_DbgPrint(MAX_TRACE, ("Freeing Scatter/Gather list\n"));
 
        SGList = NDIS_PER_PACKET_INFO_FROM_PACKET(Packet,
                                                  ScatterGatherListPacketInfo);
 
        Adapter->NdisMiniportBlock.SystemAdapterObject->
            DmaOperations->PutScatterGatherList(
                           Adapter->NdisMiniportBlock.SystemAdapterObject,
                           SGList,
                           TRUE);
 
        NDIS_PER_PACKET_INFO_FROM_PACKET(Packet,
                                         ScatterGatherListPacketInfo) = NULL;
    }
 
    (*AdapterBinding->ProtocolBinding->Chars.SendCompleteHandler)(
        AdapterBinding->NdisOpenBlock.ProtocolBindingContext,
        Packet,
        Status);
 
    KeLowerIrql(OldIrql);
 
    MiniWorkItemComplete(Adapter, NdisWorkItemSend);
}

Referenced by MiniportWorker(), NdisIPnPStartDevice(), NdisMSendComplete(), ProSendPackets(), and ScatterGatherSendPacket().

MiniWorkItemComplete()

VOID MiniWorkItemComplete	(	PLOGICAL_ADAPTER	Adapter,
		NDIS_WORK_ITEM_TYPE	WorkItemType
	)

Definition at line 964 of file miniport.c.

{
    PIO_WORKITEM IoWorkItem;
 
    /* Check if there's anything queued to run after this work item */
    if (!MiniIsBusy(Adapter, WorkItemType))
        return;
 
    /* There is, so fire the worker */
    IoWorkItem = IoAllocateWorkItem(Adapter->NdisMiniportBlock.DeviceObject);
    if (IoWorkItem)
        IoQueueWorkItem(IoWorkItem, MiniportWorker, DelayedWorkQueue, IoWorkItem);
}

Referenced by MiniDoRequest(), MiniRequestComplete(), MiniReset(), MiniSendComplete(), MiniSendResourcesAvailable(), and proSendPacketToMiniport().

NdisFindDevice()

BOOLEAN NdisFindDevice	(	UINT	VendorID,
		UINT	DeviceID,
		PUINT	BusNumber,
		PUINT	SlotNumber
	)

NdisStartDevices()

VOID NdisStartDevices

(

VOID

)

Variable Documentation

AdapterListHead

LIST_ENTRY AdapterListHead

extern

Definition at line 57 of file miniport.c.

Referenced by DriverEntry(), LANRegisterAdapter(), LANRegisterProtocol(), LANUnregisterProtocol(), MiniLocateDevice(), ndisBindMiniportsToProtocol(), and NdisIPnPStartDevice().

AdapterListLock

KSPIN_LOCK AdapterListLock

extern

Definition at line 58 of file miniport.c.

Referenced by DriverEntry(), LANRegisterAdapter(), LANRegisterProtocol(), LANUnregisterProtocol(), MiniLocateDevice(), NdisIPnPStartDevice(), and NdisIPnPStopDevice().

MiniportListHead

LIST_ENTRY MiniportListHead

extern

Definition at line 53 of file miniport.c.

Referenced by DriverEntry(), and NdisInitializeWrapper().

MiniportListLock

KSPIN_LOCK MiniportListLock

extern

Definition at line 54 of file miniport.c.

Referenced by DriverEntry(), NdisInitializeWrapper(), and NdisTerminateWrapper().