Share via


NdisMCoReceiveComplete function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisMCoReceiveComplete notifies NDIS that the processing of one or more preceding receive indications have been fully transferred so that NDIS can notify the appropriate client.

Syntax

VOID NdisMCoReceiveComplete(
  _In_ NDIS_HANDLE MiniportAdapterHandle
);

Parameters

  • MiniportAdapterHandle [in]
    Specifies the NDIS-supplied handle that the miniport driver originally obtained as an input parameter to its MiniportInitialize function.

Return value

None

Remarks

After one or more calls to NdisMCoIndicateReceivePacket, a connection-oriented NIC driver must call NdisMCoReceiveComplete to notify NDIS that its preceding indications of incoming transfers over the network have completed. The miniport driver's call to NdisMCoReceiveComplete prompts NDIS to notify the client or stand-alone call manager to which NDIS has recently posted the NIC driver's receive indications so that the protocol can begin postprocessing the received data.

When a miniport driver calls NdisMCoReceiveComplete, NDIS indicates the completion of receive operation(s) by calling the protocol's ProtocolReceiveComplete function. ProtocolReceiveComplete functions do not operate under the severe time constraints of the corresponding ProtocolCoReceivePacket functions. However, another receive indication to the ProtocolCoReceivePacket function can come in while the ProtocolReceiveComplete function is running.

A miniport driver need not call NdisMCoReceiveComplete in one-to-one correspondence with its calls to NdisMCoIndicateReceivePacket. That is, the NIC driver can issue a single receive-complete indication for some number of receive indications on a VC, particularly when network traffic is high. At a minimum, a connection-oriented miniport driver must call NdisMCoReceiveComplete at least once from its MiniportHandleInterrupt function after making one or more receive indications on any particular VC.

Requirements

Target platform

Universal

Version

Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

DISPATCH_LEVEL

See also

MiniportHandleInterrupt

MiniportInitialize

MiniportReturnPacket

NdisMCoIndicateReceivePacket

ProtocolCoReceivePacket

ProtocolReceiveComplete

 

 

Send comments about this topic to Microsoft