Функция 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
Указывает дескриптор, возвращаемый NdisOpenAdapter, который определяет виртуальный адаптер или сетевой адаптер, который должен быть закрыт.
Возвращаемое значение
Никакой
Замечания
Возвращаемое значение: None
Драйвер протокола обычно вызывает NdisCloseAdapter из функции ProtocolUnbindAdapter. Он также может вызывать NdisCloseAdapter из функции ProtocolBindAdapter, например, если не удалось задать значение OID после вызова NdisOpenAdapter для настройки привязки.
Как только протокол вызывает NdisCloseAdapter, дескриптор на NdisBindingHandle должен считаться недопустимым вызывающим. Это ошибка программирования для передачи этого дескриптора в любой последующий вызов функции NdisXxx.
- Целевая платформа: универсальная
- Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Вместо этого используйте NdisCloseAdapterEx. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | PASSIVE_LEVEL |