ProtocolReceiveComplete
ProtocolReceiveComplete is a required driver function in any protocol. ProtocolReceiveComplete completes postprocessing of one or more preceding receive indications from a network adapter driver.
VOID
ProtocolReceiveComplete(
IN NDIS_HANDLE ProtocolBindingContext );
Parameters
- ProtocolBindingContext
Specifies the handle to a protocol-allocated context area in which the protocol driver maintains per-binding runtime state. The driver supplied this handle when it called NdisOpenAdapter.
Comments
ProtocolReceiveComplete performs postprocessing, such as notifying interested clients of processed data received from a remote node, after one or more calls to the driver's ProtocolReceive function.
When an underlying miniport calls NdisM..IndicateReceiveComplete, NDIS calls the ProtocolReceiveComplete function(s) of bound protocol(s). NDIS always calls ProtocolReceiveComplete after one or more calls to the driver's ProtocolReceive function, regardless of whether any particular packet(s) are accepted by bound protocols.
An underlying miniport need not make calls to NdisM..IndicateReceive in one-to-one correspondence with its calls to NdisM..IndicateReceiveComplete. ProtocolReceiveComplete is re-entrant because the underlying network adapter driver sometimes must wait to call NdisM..IndicateReceiveComplete until no receive operations are in progress.
After ProtocolReceiveComplete is called, the underlying network adapter driver can make another receive indication before ProtocolReceiveComplete returns control, so ProtocolReceiveComplete can execute concurrently with the driver's ProtocolReceive function in SMP machines.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.0 and later | Ndis.h | Ndislib.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
ProtocolReceive, NdisOpenAdapter
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.