NdisCompleteBindAdapterEx function (ndis.h)
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) |