NdisCompleteBindAdapter 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.
NdisCompleteBindAdapter completes a binding operation for which the caller's ProtocolBindAdapter function previously returned NDIS_STATUS_PENDING.
Syntax
VOID NdisCompleteBindAdapter(
_In_ NDIS_HANDLE BindAdapterContext,
_In_ NDIS_STATUS Status,
_In_ NDIS_STATUS OpenStatus
);
Parameters
BindAdapterContext [in]
Specifies the BindContext handle passed in to ProtocolBindAdapter.Status [in]
Specifies the final status of the completed bind operation.OpenStatus [in]
Specifies the status returned by the preceding call to NdisOpenAdapter for this binding attempt.
Return value
None
Remarks
When a protocol returns NDIS_STATUS_PENDING from its ProtocolBindAdapter function, that driver must eventually call NdisCompleteBindAdapter when the binding operation is completed.
If the binding operation was successful, the protocol is ready to accept receive indications from underlying drivers and to send transmit, query, and set requests down to the underlying driver(s). If NdisCompleteBindAdapter is called with an input error Status, the binding attempt failed and the protocol has released any resources it allocated to establish the binding.
In either case, the protocol calls NdisCompleteBindAdapter to notify the NDIS library of the completion of the binding operation that this driver initiated when its ProtocolBindAdapter function called NdisOpenAdapter.
Requirements
Target platform |
Universal |
Version |
Not supported for NDIS 6.0 drivers in Windows Vista. Use NdisCompleteBindAdapterExinstead. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP. |
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
PASSIVE_LEVEL. |
See also
NdisIMInitializeDeviceInstance