NdisUnbindAdapter (Compact 2013)

3/26/2014

Protocol drivers call this function to request NDIS to close a binding to an underlying miniport adapter.

Syntax

NDIS_STATUS
  NdisUnbindAdapter(
    IN NDIS_HANDLE  NdisBindingHandle
    );

Parameters

  • NdisBindingHandle
    A handle that the protocol driver obtained from a call to the NdisOpenAdapterEx function. The handle identifies the binding to close.

Return Value

NdisUnbindAdapter returns one of the following status values:

Value

Meaning

NDIS_STATUS_SUCCESS

NdisUnbindAdapter successfully initiated the unbind operation.

NDIS_STATUS_RESOURCES

NdisUnbindAdapter failed because of insufficient resources.

Remarks

Protocol drivers call NdisUnbindAdapter outside the context of the ProtocolUnbindAdapterEx or ProtocolBindAdapterEx functions. NDIS schedules a work item to call the protocol driver's ProtocolUnbindAdapterEx function and returns immediately.

Before the call to NdisUnbindAdapter returns, NDIS can already have closed the binding. Therefore, after the call returns, the caller must not assume that the handle it passed to the NdisBindingHandle parameter is still valid.

Note   NDIS might not call ProtocolUnbindAdapterEx even if NdisUnbindAdapter returns NDIS_STATUS_SUCCESS.

Requirements

Header

ndis.h

See Also

Reference

NDIS Functions for Protocol Drivers
NdisOpenAdapterEx
ProtocolBindAdapterEx
ProtocolUnbindAdapterEx