Return to transfer.c CVS log

Up to [WindowsNT SDKs] / ntddk / src / network / sonic

Annotation of ntddk/src/network/sonic/transfer.c, revision 1.1.1.1

1.1       root        1: /*++
                      2: 
                      3: Copyright (c) 1990-1992  Microsoft Corporation
                      4: 
                      5: Module Name:
                      6: 
                      7:     transfer.c
                      8: 
                      9: Abstract:
                     10: 
                     11:     This file contains the code to implement the MacTransferData
                     12:     API for the NDIS 3.0 interface.
                     13: 
                     14: Author:
                     15: 
                     16:     Anthony V. Ercolano (Tonye) 12-Sept-1990
                     17: 
                     18: Environment:
                     19: 
                     20:     Kernel Mode - Or whatever is the equivalent.
                     21: 
                     22: Revision History:
                     23: 
                     24: 
                     25: --*/
                     26: 
                     27: #include <ndis.h>
                     28: #include <efilter.h>
                     29: 
                     30: #include <sonichrd.h>
                     31: #include <sonicsft.h>
                     32: 
                     33: 
                     34: extern
                     35: NDIS_STATUS
                     36: SonicTransferData(
                     37:     IN NDIS_HANDLE MacBindingHandle,
                     38:     IN NDIS_HANDLE MacReceiveContext,
                     39:     IN UINT ByteOffset,
                     40:     IN UINT BytesToTransfer,
                     41:     OUT PNDIS_PACKET Packet,
                     42:     OUT PUINT BytesTransferred
                     43:     )
                     44: 
                     45: /*++
                     46: 
                     47: Routine Description:
                     48: 
                     49:     A protocol calls the SonicTransferData request (indirectly via
                     50:     NdisTransferData) from within its Receive event handler
                     51:     to instruct the MAC to copy the contents of the received packet
                     52:     a specified paqcket buffer.
                     53: 
                     54: Arguments:
                     55: 
                     56:     MacBindingHandle - The context value returned by the MAC when the
                     57:     adapter was opened.  In reality this is a pointer to SONIC_OPEN.
                     58: 
                     59:     MacReceiveContext - The context value passed by the MAC on its call
                     60:     to NdisIndicateReceive.  The MAC can use this value to determine
                     61:     which packet, on which adapter, is being received.
                     62: 
                     63:     ByteOffset - An unsigned integer specifying the offset within the
                     64:     received packet at which the copy is to begin.  If the entire packet
                     65:     is to be copied, ByteOffset must be zero.
                     66: 
                     67:     BytesToTransfer - An unsigned integer specifying the number of bytes
                     68:     to copy.  It is legal to transfer zero bytes; this has no effect.  If
                     69:     the sum of ByteOffset and BytesToTransfer is greater than the size
                     70:     of the received packet, then the remainder of the packet (starting from
                     71:     ByteOffset) is transferred, and the trailing portion of the receive
                     72:     buffer is not modified.
                     73: 
                     74:     Packet - A pointer to a descriptor for the packet storage into which
                     75:     the MAC is to copy the received packet.
                     76: 
                     77:     BytesTransfered - A pointer to an unsigned integer.  The MAC writes
                     78:     the actual number of bytes transferred into this location.  This value
                     79:     is not valid if the return status is STATUS_PENDING.
                     80: 
                     81: Return Value:
                     82: 
                     83:     The function value is the status of the operation.
                     84: 
                     85: 
                     86: --*/
                     87: 
                     88: {
                     89: 
                     90:     PSONIC_ADAPTER Adapter;
                     91: 
                     92:     NDIS_STATUS StatusToReturn;
                     93: 
                     94:     Adapter = PSONIC_ADAPTER_FROM_BINDING_HANDLE(MacBindingHandle);
                     95: 
                     96:     NdisAcquireSpinLock(&Adapter->Lock);
                     97:     Adapter->References++;
                     98: 
                     99:     if (!Adapter->ResetInProgress) {
                    100: 
                    101:         PSONIC_OPEN Open = PSONIC_OPEN_FROM_BINDING_HANDLE(MacBindingHandle);
                    102: 
                    103:         if (!Open->BindingShuttingDown) {
                    104: 
                    105:             Open->References++;
                    106: 
                    107:             NdisReleaseSpinLock(&Adapter->Lock);
                    108: 
                    109:             //
                    110:             // Determine if this was a loopback packet.
                    111:             //
                    112: 
                    113:             if (MacReceiveContext == (NDIS_HANDLE)NULL) {
                    114: 
                    115:                 NdisCopyFromPacketToPacket(
                    116:                     Packet,
                    117:                     0,
                    118:                     BytesToTransfer,
                    119:                     Adapter->CurrentLoopbackPacket,
                    120:                     ByteOffset + 14,
                    121:                     BytesTransferred
                    122:                     );
                    123: 
                    124:             } else {
                    125: 
                    126:                 SonicCopyFromBufferToPacket(
                    127:                     (PCHAR)MacReceiveContext + ByteOffset,
                    128:                     BytesToTransfer,
                    129:                     Packet,
                    130:                     0,
                    131:                     BytesTransferred
                    132:                     );
                    133: 
                    134:             }
                    135: 
                    136:             NdisAcquireSpinLock(&Adapter->Lock);
                    137:             Open->References--;
                    138:             StatusToReturn = NDIS_STATUS_SUCCESS;
                    139: 
                    140:         } else {
                    141: 
                    142:             StatusToReturn = NDIS_STATUS_REQUEST_ABORTED;
                    143: 
                    144:         }
                    145: 
                    146:     } else {
                    147: 
                    148:         StatusToReturn = NDIS_STATUS_RESET_IN_PROGRESS;
                    149: 
                    150:     }
                    151: 
                    152:     SONIC_DO_DEFERRED(Adapter);
                    153:     return StatusToReturn;
                    154: }

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.