Поделиться через

Функция NdisIfFreeNetLuidIndex (ndis.h)

  • Статья

Функция NdisIfFreeNetLuidIndex освобождает сетевой интерфейс NET_LUID индекс, который ранее был выделен вызовом Функция NdisIfAllocateNetLuidIndex .

Синтаксис

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

Параметры

ifType

Тип интерфейса, для который был выделен индекс. Вызывающий объект должен предоставить то же значение, которое использовалось при выделении индекса NET_LUID с помощью NdisIfAllocateNetLuidIndex. Список типов интерфейсов см. в разделе Типы интерфейсов NDIS.

[in] NetLuidIndex

Значение индекса NET_LUID, которое должен освободить NDIS. Этот индекс был выделен в предыдущем вызове NdisIfAllocateNetLuidIndex.

Возвращаемое значение

NdisIfFreeNetLuidIndex возвращает одно из следующих значений:

Код возврата Описание
NDIS_STATUS_SUCCESS
 Операция выполнена успешно.
DIS_STATUS_INVALID_PARAMETER
 Ошибка NdisIfFreeNetLuidIndex , так как параметр NetLuidIndex указал индекс, который не был выделен для типа, указанного параметром IfType .
 

Если вызов NdisIfFreeNetLuidIndex завершается сбоем, поставщик интерфейса должен удалить все сведения, сохраненные в постоянном хранилище, связанном с индексом. Удаление сведений гарантирует, что поставщик не будет пытаться освободить индекс, который уже был освобожден после перезагрузки компьютера.

Комментарии

Поставщики интерфейсов NDIS вызывают функцию NdisIfFreeNetLuidIndex , чтобы освободить индекс NET_LUID . Поставщик интерфейса должен освободить индекс NET_LUID только в том случае, если интерфейс больше не будет использоваться на локальном компьютере.

NdisIfFreeNetLuidIndex возвращает ранее выделенный индекс NET_LUID в NDIS для возможного перераспределения в другой интерфейс. Вызывающий объект должен передать тот же тип интерфейса в IfType , который использовался при вызовеФункция NdisIfAllocateNetLuidIndex для выделения индекса NET_LUID.

Поставщик не должен использовать освобожденный индекс NET_LUID или связанное значение NET_LUID в любых других вызовах функций NDIS после вызова NdisIfFreeNetLuidIndex.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL
Правила соответствия DDI Irql_Interfaces_Function(ndis)

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

NET_LUID

NdisIfAllocateNetLuidIndex