 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function notifies NDIS that a Token Ring receive packet, identified in a preceding call to NdisMTrIndicateReceive, has been fully transferred by the NIC so that NDIS can notify the appropriate bound protocol drivers.
VOID NdisMTrIndicateReceiveComplete( IN NDIS_HANDLE MiniportAdapterHandle );
Parameters
- MiniportAdapterHandle
- [in] Specifies the handle originally input to
MiniportInitialize.
Return Values
None.
Remarks
After any Token Ring receive indication, a miniport eventually must call NdisMTrIndicateReceiveCompleteto indicate the end of the transfer operation over the net, even if a particular packet is accepted by no bound protocol.
NdisMTrIndicateReceiveCompleteboth indicates the completion of a transfer operation for a receive and notifies any bound protocol that has already consumed the initial indication that it can begin post-processing the received data.
When a miniport calls NdisMTrIndicateReceiveComplete, NDIS indicates the completion of the receive operation to each such protocol by calling its ProtocolReceiveCompletefunction.
ProtocolReceiveCompletefunctions need not operate under the severe time constraints of the corresponding ProtocolReceivefunctions. However, another receive indication to the ProtocolReceivefunction can come in while the ProtocolReceiveCompletefunction is running.
A miniport need not call NdisMTrIndicateReceiveCompletein one-to-one correspondence with its calls to NdisMTrIndicateReceive. That is, a NIC driver can issue a single receive-complete indication for some number of receive indications, particularly when network traffic is high. For example, when a miniport is continually indicating receives from the same source; it might call NdisMTrIndicateReceiveCompleteonce for every ten indications. On the other hand, a miniport might call NdisMTrIndicateReceiveCompleteonce for each indication when network traffic is low so that the driver can regain ownership of the memory it allocated for receives promptly. However, a miniport must call NdisMTrIndicateReceiveCompleteat least once per batch of packets indicated from its MiniportHandleInterruptfunction.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 3.0 and later Ndis.h
Last updated on Tuesday, July 13, 2004