NdisCloseAdapter 函式 (ndis.h)

注意 NDIS 5. x 已被取代，且由 NDIS 6 取代。 x。如需新的 NDIS 驅動程式開發，請參閱從 Windows Vista 開始的網路驅動程式。如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x，請參閱將 NDIS 5.x 驅動程式移植到 NDIS 6.0。

NdisCloseAdapter 會釋放已建立的系結，以及在稱為 NdisOpenAdapter 的通訊協定時配置的資源。

語法

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

[out] Status

呼叫端提供的變數指標，此變數會傳回關閉作業的狀態，可以是下列其中一個值：

NDIS_STATUS_SUCCESS
系結已關閉，且已釋放與該系結相關的所有資源。
NDIS_STATUS_PENDING
關閉配接器要求會以異步方式處理，而呼叫端的 ProtocolCloseAdapterComplete 函式會在關閉作業完成時呼叫。

[in] NdisBindingHandle

指定要關閉之虛擬配接器或 NIC 的 NdisOpenAdapter 所傳回的句柄。

無

傳回值：無

通訊協議驅動程式通常會從其 ProtocolUnbindAdapter 函式呼叫 NdisCloseAdapter。它也可以從 ProtocolBindAdapter 函式呼叫 NdisCloseAdapter，例如，如果在呼叫 NdisOpenAdapter 以設定系結之後無法設定 OID 值。

一旦通訊協定呼叫 NdisCloseAdapter，呼叫端應該將 NdisBindingHandle 的句柄視為無效。在 後續呼叫 NdisXxx 函式時，這是將這個句柄傳遞至程式設計錯誤。

目標平臺：通用
版本：Windows Vista 中不支援 NDIS 6.0 驅動程式。請改用 NdisCloseAdapterEx。 Windows Vista 和 Windows XP 中支援 NDIS 5.1 驅動程式。