NdisCompleteBindAdapterEx function (ndis.h)

Article
02/22/2024

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

Syntax

void NdisCompleteBindAdapterEx(
       NDIS_HANDLE BindAdapterContext,
  [in] NDIS_STATUS Status
);

Parameters

BindAdapterContext

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

[in] 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 NIC.

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 carry out 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 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

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Target Platform	Desktop
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	Irql_Protocol_Driver_Function(ndis)