NdisCloseAdapterEx 函式 (ndis.h)

  • 發行項

通訊協議驅動程式會呼叫 NdisCloseAdapterEx 函 式，以釋放驅動程式呼叫 NdisOpenAdapterEx 函式時所配置的系結和資源。

語法

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

參數

[in] NdisBindingHandle

NDIS 在 NdisOpenAdapterEx 的 NdisBindingHandle 參數所提供的句柄。 此句柄會識別 NDIS 應該關閉的系結。

傳回值

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

傳回碼 Description
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx 已成功關閉系結至基礎迷你埠配接器。
NDIS_STATUS_PENDING
 NdisCloseAdapterEx 未完成關閉作業，且作業會以異步方式完成。 NDIS 會呼叫通訊協定驅動程式的當作業完成時，ProtocolCloseAdapterCompleteEx 函式。

備註

通訊協定驅動程式通常會從其呼叫 NdisCloseAdapterEx ProtocolUnbindAdapterEx 函 式。 驅動程式也可以從其 ProtocolBindAdapterEx 函式呼叫 NdisCloseAdapterEx。 例如，如果驅動程式在呼叫 NdisOpenAdapterEx 之後無法設定 OID 值，它可以從其 ProtocolBindAdapterEx 函式呼叫 NdisCloseAdapterEx。

如果通訊協定驅動程式必須在 ProtocolUnbindAdapterEx 或 ProtocolBindAdapterEx 的內容外關閉迷你埠配接器，則必須呼叫 NdisUnbindAdapter 函 式。

通訊協定驅動程式應該等候所有傳送要求和它們源自的 OID 要求完成，再呼叫 NdisCloseAdapterEx。

一旦驅動程式呼叫 NdisCloseAdapterEx，從 NdisOpenAdapterEx 函式取得的句柄就會變成無效。

規格需求

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

另請參閱

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx