Функция 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 возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
|
Операция успешно завершена. |
|
сбой 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 (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | Irql_Interfaces_Function(ndis) |