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