Функция 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

Remarks

Возвращаемое значение: 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 (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL

См. также раздел