NdisUnbindAdapter 函式 (ndis.h)

  • 發行項

通訊協定驅動程式會呼叫 NdisUnbindAdapter 函 式，要求 NDIS 關閉基礎迷你埠配接器的系結。

語法

NDIS_STATUS NdisUnbindAdapter(
  [in] NDIS_HANDLE NdisBindingHandle
);

參數

[in] NdisBindingHandle

通訊協議驅動程式從 呼叫 NdisOpenAdapterEx 函式取得的句柄。 句柄會識別要關閉的系結。

傳回值

NdisUnbindAdapter 會傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 NdisUnbindAdapter 已成功起始解除系結作業。
NDIS_STATUS_RESOURCES
 NdisUnbindAdapter 因為資源不足而失敗。

備註

通訊協議驅動程式會在 ProtocolUnbindAdapterEx 或 ProtocolBindAdapterEx 函式的內容之外呼叫 NdisUnbindAdapter。 NDIS 會排程工作專案來呼叫通訊協定驅動程式的 ProtocolUnbindAdapterEx 函式，並立即傳回。

呼叫 NdisUnbindAdapter 之前，NDIS 可能已經關閉系結。 因此，在呼叫傳回之後，呼叫端不得假設傳遞給 NdisBindingHandle 參數的句柄仍然有效。

注意即使 NdisUnbindAdapter 傳回NDIS_STATUS_SUCCESS，NDIS 可能不會呼叫 ProtocolUnbindAdapterEx。
 

規格需求

需求 值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平台 桌面
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_Protocol_Driver_Function ()

另請參閱

NdisOpenAdapterEx

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx