Compartir a través de

Función NdisIfFreeNetLuidIndex (ndis.h)

  • Artículo

La función NdisIfFreeNetLuidIndex libera una interfaz de red NET_LUID índice asignado previamente por una llamada a . Función NdisIfAllocateNetLuidIndex .

Sintaxis

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

Parámetros

ifType

Tipo de interfaz para el que se asignó el índice. El autor de la llamada debe proporcionar el mismo valor que usó cuando asignó el índice de NET_LUID con NdisIfAllocateNetLuidIndex. Para obtener una lista de tipos de interfaz, consulte Tipos de interfaz NDIS.

[in] NetLuidIndex

Valor de índice NET_LUID que NDIS debe liberar. Este índice se asignó en una llamada anterior a NdisIfAllocateNetLuidIndex.

Valor devuelto

NdisIfFreeNetLuidIndex devuelve uno de los siguientes valores:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 La operación se ha completado correctamente.
DIS_STATUS_INVALID_PARAMETER
 Error en NdisIfFreeNetLuidIndex porque el parámetro NetLuidIndex especificó un índice que no se asignó para el tipo especificado por el parámetro IfType .
 

Si se produce un error en la llamada a NdisIfFreeNetLuidIndex , el proveedor de interfaz debe quitar cualquier información que haya guardado en el almacenamiento persistente relacionado con el índice. Al quitar la información, se asegurará de que el proveedor no intente liberar un índice que ya esté liberado después de reiniciar el equipo.

Comentarios

Los proveedores de interfaz NDIS llaman a la función NdisIfFreeNetLuidIndex para liberar un índice de NET_LUID . El proveedor de interfaz debe liberar el índice de NET_LUID solo si la interfaz ya no se usará en el equipo local.

NdisIfFreeNetLuidIndex devuelve un índice de NET_LUID asignado previamente a NDIS para una posible reasignación a otra interfaz. El llamador debe pasar el mismo tipo de interfaz en IfType que usó cuando llamó a . Función NdisIfAllocateNetLuidIndex para asignar el índice NET_LUID.

El proveedor no debe usar el índice de NET_LUID liberado o el valor de NET_LUID asociado en cualquier otra llamada de función NDIS después de llamar a NdisIfFreeNetLuidIndex.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI Irql_Interfaces_Function(ndis)

Consulte también

NET_LUID

NdisIfAllocateNetLuidIndex