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

See also

MiniportHandleInterrupt

MiniportInitialize

MiniportReturnPacket

NdisMCoIndicateReceivePacket

ProtocolCoReceivePacket

ProtocolReceiveComplete

Send comments about this topic to Microsoft