NdisCompleteBindAdapter

NdisCompleteBindAdapter

VOID
   NdisCompleteBindAdapter(
       IN NDIS_HANDLE BindAdapterContext,
       IN NDIS_STATUS Status,
       IN NDIS_STATUS OpenStatus
       );

NdisCompleteBindAdapter completes a binding operation for which the caller’s ProtocolBindAdapter function previously returned NDIS_STATUS_PENDING.

Parameters

BindAdapterContext

Specifies the BindContext handle passed in to ProtocolBindAdapter.

Status

Specifies the final status of the completed bind operation.

OpenStatus

Specifies the status returned by the preceding call to NdisOpenAdapter for this binding attempt.

Comments

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.

Callers of NdisCompleteBindAdapter run at IRQL PASSIVE_LEVEL.