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

MiniportInitialize

NdisIMInitializeDeviceInstance

NdisOpenAdapter

NdisRequest

ProtocolBindAdapter

ProtocolUnbindAdapter

Send comments about this topic to Microsoft