NdisCompleteBindAdapterEx (Compact 2013)

3/26/2014

A protocol driver calls this function to complete a binding operation for which the driver's ProtocolBindAdapterEx function returned NDIS_STATUS_PENDING.

Syntax

VOID
  NdisCompleteBindAdapterEx(
    IN NDIS_HANDLE  BindContext,
    IN NDIS_STATUS  Status
    ); 

Parameters

• BindContext
  The handle that NDIS passed to the BindContext parameter of the ProtocolBindAdapterEx function.

• Status
  The final status of the completed bind operation. This parameter can be one of the following values:

  • NDIS_STATUS_SUCCESS
    The driver successfully completed the binding to the underlying network adapter.
  • NDIS_STATUS_XXX or NTSTATUS_XXX
    The protocol driver's attempt to set up a binding failed or the protocol driver could not allocate the resources it needed to perform network I/O operations. Usually, such an error status is propagated from an NdisXxx function or a kernel-mode support routine.

Return Value

None

Remarks

If a protocol driver returns NDIS_STATUS_PENDING from its ProtocolBindAdapterEx function, that driver must call NdisCompleteBindAdapterEx after the binding operation is is completed.

If the open operation was successful, the protocol driver is ready to accept receive indications from underlying drivers and to initiate send requests and OID requests on the binding. If the driver calls NdisCompleteBindAdapterEx with an error status, the binding attempt failed and the driver has released any resources it allocated to establish the binding.

Requirements

Header

ndis.h

See Also

Reference

NDIS Functions for Protocol Drivers
NdisOpenAdapterEx
ProtocolBindAdapterEx