Функция NdisCloseAdapterEx (ndis.h)
Драйвер протокола вызывает функцию NdisCloseAdapterEx для освобождения привязки и ресурсов, выделенных при вызове драйвера NdisOpenAdapterEx.
Синтаксис
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
Параметры
[in] NdisBindingHandle
Дескриптор, предоставленный NDIS в параметре NdisBindingHandleNdisOpenAdapterEx. Этот дескриптор определяет привязку, которую должен закрыть NDIS.
Возвращаемое значение
NdisCloseAdapterEx возвращает одно из следующих значений состояния:
| Возвращаемый код | Описание |
|---|---|
|
NdisCloseAdapterEx успешно закрыл привязку к базовому минипорт-адаптеру. |
|
NdisCloseAdapterEx не завершил операцию закрытия, и операция будет завершена асинхронно. NDIS вызывает драйвер протокола функция ProtocolCloseAdapterCompleteEx после завершения операции. |
Замечания
Драйвер протокола обычно вызывает NdisCloseAdapterEx из нее функция ProtocolUnbindAdapterEx. Драйвер также может вызывать NdisCloseAdapterEx из функции ProtocolBindAdapterEx. Например, если драйвер не удалось задать значение OID после вызова NdisOpenAdapterEx, он может вызывать NdisCloseAdapterEx из функции ProtocolBindAdapterEx.
Если драйвер протокола должен закрыть мини-адаптер вне контекста ProtocolUnbindAdapterEx или ProtocolBindAdapterEx, он должен вызвать функцию NdisUnbindAdapter.
Драйверы протоколов должны ожидать завершения всех запросов отправки и запросов OID, прежде чем вызывать NdisCloseAdapterEx.
Как только драйвер вызывает NdisCloseAdapterEx, дескриптор, полученный из функции NdisOpenAdapterEx в параметре NdisBindingHandle становится недопустимым.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается в NDIS 6.0 и более поздних версиях. |
| целевая платформа | Настольный |
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | Irql_Protocol_Driver_Function(ndis) |