Return to transfer.c CVS log

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

Annotation of ntddk/src/network/ibmtok/transfer.c, revision 1.1

1.1     ! root        1: /*++
        !             2: 
        !             3: Copyright (c) 1990  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:     Adam Barr (adamba) 15-Mar-1991
        !            18: 
        !            19: Environment:
        !            20: 
        !            21:     Kernel Mode - Or whatever is the equivalent.
        !            22: 
        !            23: Revision History:
        !            24: 
        !            25: 
        !            26: --*/
        !            27: 
        !            28: #pragma optimize("",off)
        !            29: 
        !            30: #include <ndis.h>
        !            31: 
        !            32: #include <tfilter.h>
        !            33: #include <tokhrd.h>
        !            34: #include <toksft.h>
        !            35: 
        !            36: 
        !            37: extern
        !            38: NDIS_STATUS
        !            39: IbmtokTransferData(
        !            40:     IN NDIS_HANDLE MacBindingHandle,
        !            41:     IN NDIS_HANDLE MacReceiveContext,
        !            42:     IN UINT ByteOffset,
        !            43:     IN UINT BytesToTransfer,
        !            44:     OUT PNDIS_PACKET Packet,
        !            45:     OUT PUINT BytesTransferred
        !            46:     )
        !            47: 
        !            48: /*++
        !            49: 
        !            50: Routine Description:
        !            51: 
        !            52:     A protocol calls the IbmtokTransferData request (indirectly via
        !            53:     NdisTransferData) from within its Receive event handler
        !            54:     to instruct the MAC to copy the contents of the received packet
        !            55:     a specified packet buffer.
        !            56: 
        !            57: Arguments:
        !            58: 
        !            59:     MacBindingHandle - The context value returned by the MAC when the
        !            60:     adapter was opened.  In reality this is a pointer to IBMTOK.
        !            61: 
        !            62:     MacReceiveContext - The context value passed by the MAC on its call
        !            63:     to NdisIndicateReceive.  The MAC can use this value to determine
        !            64:     which packet, on which adapter, is being received.
        !            65: 
        !            66:     ByteOffset - An unsigned integer specifying the offset within the
        !            67:     received packet at which the copy is to begin.  If the entire packet
        !            68:     is to be copied, ByteOffset must be zero.
        !            69: 
        !            70:     BytesToTransfer - An unsigned integer specifying the number of bytes
        !            71:     to copy.  It is legal to transfer zero bytes; this has no effect.  If
        !            72:     the sum of ByteOffset and BytesToTransfer is greater than the size
        !            73:     of the received packet, then the remainder of the packet (starting from
        !            74:     ByteOffset) is transferred, and the trailing portion of the receive
        !            75:     buffer is not modified.
        !            76: 
        !            77:     Packet - A pointer to a descriptor for the packet storage into which
        !            78:     the MAC is to copy the received packet.
        !            79: 
        !            80:     BytesTransfered - A pointer to an unsigned integer.  The MAC writes
        !            81:     the actual number of bytes transferred into this location.  This value
        !            82:     is not valid if the return status is STATUS_PENDING.
        !            83: 
        !            84: Return Value:
        !            85: 
        !            86:     The function value is the status of the operation.
        !            87: 
        !            88: 
        !            89: --*/
        !            90: 
        !            91: {
        !            92: 
        !            93:     PIBMTOK_ADAPTER Adapter;
        !            94: 
        !            95:     NDIS_STATUS StatusToReturn;
        !            96: 
        !            97:     Adapter = PIBMTOK_ADAPTER_FROM_BINDING_HANDLE(MacBindingHandle);
        !            98: 
        !            99:     NdisAcquireSpinLock(&Adapter->Lock);
        !           100:     Adapter->References++;
        !           101: 
        !           102:     if (!Adapter->NotAcceptingRequests) {
        !           103: 
        !           104:         PIBMTOK_OPEN Open = PIBMTOK_OPEN_FROM_BINDING_HANDLE(MacBindingHandle);
        !           105: 
        !           106:         if (!Open->BindingShuttingDown) {
        !           107: 
        !           108:             //
        !           109:             // The code in this section is quite similar to the
        !           110:             // code in CopyFromPacketToPacket.  It could easily go
        !           111:             // into its own routine, except that it is not likely
        !           112:             // to be used in any other implementation.
        !           113:             //
        !           114:             SRAM_PTR SourceReceiveBuffer =
        !           115:                 Adapter->IndicatedReceiveBuffer;
        !           116: 
        !           117:             //
        !           118:             // Holds the count of the number of ndis buffers comprising
        !           119:             // the destination packet.
        !           120:             //
        !           121:             UINT DestinationBufferCount;
        !           122: 
        !           123:             //
        !           124:             // Points to the buffer into which we are putting data.
        !           125:             //
        !           126:             PNDIS_BUFFER DestinationCurrentBuffer;
        !           127: 
        !           128:             //
        !           129:             // Holds the virtual address of the current destination
        !           130:             // buffer.
        !           131:             //
        !           132:             PVOID DestinationVirtualAddress;
        !           133: 
        !           134:             //
        !           135:             // Holds the virtual address of the current source buffer.
        !           136:             //
        !           137:             PRECEIVE_BUFFER SourceBufferAddress;
        !           138: 
        !           139:             //
        !           140:             // Holds the address of the data in the current source buffer.
        !           141:             //
        !           142:             PVOID SourceVirtualAddress;
        !           143: 
        !           144:             //
        !           145:             // Holds the length of the current destination buffer.
        !           146:             //
        !           147:             UINT DestinationCurrentLength;
        !           148: 
        !           149:             //
        !           150:             // Holds the length of the current source buffer.
        !           151:             //
        !           152:             UINT SourceCurrentLength;
        !           153: 
        !           154:             //
        !           155:             // Keep a local variable of BytesTransferred so we aren't
        !           156:             // referencing through a pointer.
        !           157:             //
        !           158:             UINT LocalBytesTransferred = 0;
        !           159: 
        !           160:             USHORT PortValue;
        !           161: 
        !           162:             Open->References++;
        !           163: 
        !           164:             NdisReleaseSpinLock(&Adapter->Lock);
        !           165: 
        !           166:             *BytesTransferred = 0;
        !           167: 
        !           168:             ASSERT(sizeof(UINT) >= 2);
        !           169:             ASSERT(sizeof(UINT) == sizeof(NDIS_HANDLE));
        !           170: 
        !           171:             //
        !           172:             // Get the first buffer of the destination.
        !           173:             //
        !           174: 
        !           175:             NdisQueryPacket(
        !           176:                 Packet,
        !           177:                 NULL,
        !           178:                 &DestinationBufferCount,
        !           179:                 &DestinationCurrentBuffer,
        !           180:                 NULL
        !           181:                 );
        !           182: 
        !           183:             //
        !           184:             // Could have a null packet.
        !           185:             //
        !           186: 
        !           187:             if (DestinationBufferCount != 0) {
        !           188: 
        !           189:                 NdisQueryBuffer(
        !           190:                     DestinationCurrentBuffer,
        !           191:                     &DestinationVirtualAddress,
        !           192:                     &DestinationCurrentLength
        !           193:                     );
        !           194: 
        !           195:                 //
        !           196:                 // Get the information for the first buffer of the source.
        !           197:                 //
        !           198: 
        !           199:                 SourceBufferAddress = (PRECEIVE_BUFFER)
        !           200:                     ((PUCHAR)SRAM_PTR_TO_PVOID(Adapter,
        !           201:                             SourceReceiveBuffer) + 2);
        !           202: 
        !           203:                 //
        !           204:                 // Adjust the address and length to account for the
        !           205:                 // header for this frame.
        !           206:                 //
        !           207: 
        !           208:                 SourceVirtualAddress =
        !           209:                     SourceBufferAddress->FrameData +
        !           210:                     Adapter->IndicatedHeaderLength;
        !           211: 
        !           212:                 NdisReadRegisterUshort(&SourceBufferAddress->BufferLength,
        !           213:                                        &PortValue
        !           214:                                       );
        !           215: 
        !           216:                 SourceCurrentLength = IBMSHORT_TO_USHORT(PortValue) -
        !           217:                                       Adapter->IndicatedHeaderLength;
        !           218: 
        !           219: 
        !           220: 
        !           221:                 //
        !           222:                 // Take care of boundary condition of zero length copy.
        !           223:                 //
        !           224: 
        !           225:                 while (LocalBytesTransferred < BytesToTransfer) {
        !           226: 
        !           227:                     //
        !           228:                     // Check to see whether we've exhausted the current
        !           229:                     // destination buffer.  If so, move onto the next one.
        !           230:                     //
        !           231: 
        !           232:                     if (!DestinationCurrentLength) {
        !           233: 
        !           234:                         NdisGetNextBuffer(
        !           235:                             DestinationCurrentBuffer,
        !           236:                             &DestinationCurrentBuffer
        !           237:                             );
        !           238: 
        !           239:                         if (!DestinationCurrentBuffer) {
        !           240: 
        !           241:                             //
        !           242:                             // We've reached the end of the packet.  We
        !           243:                             // return with what we've done so far. (Which
        !           244:                             // must be shorter than requested.)
        !           245:                             //
        !           246: 
        !           247:                             break;
        !           248: 
        !           249:                         }
        !           250: 
        !           251:                         NdisQueryBuffer(
        !           252:                             DestinationCurrentBuffer,
        !           253:                             &DestinationVirtualAddress,
        !           254:                             &DestinationCurrentLength
        !           255:                             );
        !           256:                         continue;
        !           257: 
        !           258:                     }
        !           259: 
        !           260: 
        !           261:                     //
        !           262:                     // Check to see whether we've exhausted the current
        !           263:                     // source buffer.  If so, move onto the next one.
        !           264:                     //
        !           265: 
        !           266:                     if (!SourceCurrentLength) {
        !           267: 
        !           268:                         NdisReadRegisterUshort(
        !           269:                                      &SourceBufferAddress->NextBuffer,
        !           270:                                      &SourceReceiveBuffer
        !           271:                                      );
        !           272: 
        !           273:                         if (SourceReceiveBuffer == NULL_SRAM_PTR) {
        !           274: 
        !           275:                             //
        !           276:                             // We've reached the end of the frame.  We
        !           277:                             // return with what we've done so far. (Which
        !           278:                             // must be shorter than requested.)
        !           279:                             //
        !           280: 
        !           281:                             break;
        !           282: 
        !           283:                         }
        !           284: 
        !           285:                         SourceBufferAddress = (PRECEIVE_BUFFER)
        !           286:                           SRAM_PTR_TO_PVOID(Adapter, SourceReceiveBuffer);
        !           287: 
        !           288:                         SourceVirtualAddress =
        !           289:                             (PVOID)SourceBufferAddress->FrameData;
        !           290: 
        !           291:                         NdisReadRegisterUshort(
        !           292:                                 &SourceBufferAddress->BufferLength,
        !           293:                                 &SourceCurrentLength
        !           294:                                 );
        !           295: 
        !           296:                         SourceCurrentLength = IBMSHORT_TO_USHORT(
        !           297:                                                 SourceCurrentLength
        !           298:                                                 );
        !           299: 
        !           300:                         continue;
        !           301: 
        !           302:                     }
        !           303: 
        !           304:                     //
        !           305:                     // Try to get us up to the point to start the copy.
        !           306:                     //
        !           307: 
        !           308:                     if (ByteOffset) {
        !           309: 
        !           310:                         if (ByteOffset > SourceCurrentLength) {
        !           311: 
        !           312:                             //
        !           313:                             // What we want isn't in this buffer.
        !           314:                             //
        !           315: 
        !           316:                             ByteOffset -= SourceCurrentLength;
        !           317:                             SourceCurrentLength = 0;
        !           318:                             continue;
        !           319: 
        !           320:                         } else {
        !           321: 
        !           322:                             SourceVirtualAddress =
        !           323:                                 (PCHAR)SourceVirtualAddress + ByteOffset;
        !           324:                             SourceCurrentLength -= ByteOffset;
        !           325:                             ByteOffset = 0;
        !           326: 
        !           327:                         }
        !           328: 
        !           329:                     }
        !           330: 
        !           331:                     //
        !           332:                     // Copy the data.
        !           333:                     //
        !           334: 
        !           335:                     {
        !           336: 
        !           337:                         //
        !           338:                         // Holds the amount of data to move.
        !           339:                         //
        !           340:                         UINT AmountToMove;
        !           341: 
        !           342:                         //
        !           343:                         // Holds the amount desired remaining.
        !           344:                         //
        !           345:                         UINT Remaining = BytesToTransfer
        !           346:                                          - LocalBytesTransferred;
        !           347: 
        !           348:                         AmountToMove =
        !           349:                       ((SourceCurrentLength <= DestinationCurrentLength)?
        !           350:                        (SourceCurrentLength):(DestinationCurrentLength));
        !           351: 
        !           352:                         AmountToMove = ((Remaining < AmountToMove)?
        !           353:                                         (Remaining):(AmountToMove));
        !           354: 
        !           355:                         IBMTOK_MOVE_FROM_MAPPED_MEMORY(
        !           356:                             DestinationVirtualAddress,
        !           357:                             SourceVirtualAddress,
        !           358:                             AmountToMove
        !           359:                             );
        !           360: 
        !           361:                         DestinationVirtualAddress =
        !           362:                           (PCHAR)DestinationVirtualAddress + AmountToMove;
        !           363:                         SourceVirtualAddress =
        !           364:                             (PCHAR)SourceVirtualAddress + AmountToMove;
        !           365: 
        !           366:                         LocalBytesTransferred += AmountToMove;
        !           367:                         SourceCurrentLength -= AmountToMove;
        !           368:                         DestinationCurrentLength -= AmountToMove;
        !           369: 
        !           370:                     }
        !           371: 
        !           372:                 }
        !           373: 
        !           374:                 *BytesTransferred = LocalBytesTransferred;
        !           375: 
        !           376:             }
        !           377: 
        !           378:             NdisAcquireSpinLock(&Adapter->Lock);
        !           379:             Open->References--;
        !           380:             StatusToReturn = NDIS_STATUS_SUCCESS;
        !           381: 
        !           382:         } else {
        !           383: 
        !           384:             StatusToReturn = NDIS_STATUS_REQUEST_ABORTED;
        !           385: 
        !           386:         }
        !           387: 
        !           388:     } else {
        !           389: 
        !           390:         if (Adapter->ResetInProgress) {
        !           391: 
        !           392:             StatusToReturn = NDIS_STATUS_RESET_IN_PROGRESS;
        !           393: 
        !           394:         } else if (Adapter->OpenInProgress) {
        !           395: 
        !           396:             StatusToReturn = NDIS_STATUS_FAILURE;
        !           397: 
        !           398:         } else {
        !           399: 
        !           400:             NdisWriteErrorLogEntry(
        !           401:                 Adapter->NdisAdapterHandle,
        !           402:                 NDIS_ERROR_CODE_DRIVER_FAILURE,
        !           403:                 2,
        !           404:                 IBMTOK_ERRMSG_INVALID_STATE,
        !           405:                 1
        !           406:                 );
        !           407: 
        !           408:         }
        !           409: 
        !           410:     }
        !           411: 
        !           412:     IBMTOK_DO_DEFERRED(Adapter);
        !           413:     return StatusToReturn;
        !           414: }

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