Función NdisIfAllocateNetLuidIndex (ndis.h)
La función NdisIfAllocateNetLuidIndex asigna un índice de NET_LUID para un proveedor de interfaz de red NDIS.
Sintaxis
NDIS_STATUS NdisIfAllocateNetLuidIndex(
NET_IFTYPE ifType,
[out] PUINT32 pNetLuidIndex
);
Parámetros
ifType
Tipo de interfaz de la Autoridad de números asignados a Internet (IANA) para un índice. Por ejemplo, IF_TYPE_ETHERNET_CSMACD (6) es el valor de IfType que se asigna a cualquier interfaz similar a Ethernet. Para obtener una lista de los tipos de interfaz, consulte tipos de interfaz NDIS.
[out] pNetLuidIndex
Puntero a una variable de índice NET_LUID proporcionada por el autor de la llamada. Si la asignación se realiza correctamente, NdisIfAllocateNetLuidIndex establece esta variable en el valor de índice de NET_LUID de 24 bits asignado.
Valor devuelto
NdisIfAllocateNetLuidIndex devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
La operación se completó correctamente. |
|
Error en la operación debido a recursos insuficientes. |
Observaciones
Los proveedores de interfaz NDIS llaman a la función NdisIfAllocateNetLuidIndex para asignar un índice de NET_LUID. Un proveedor de interfaz debe asignar un índice de NET_LUID para que el proveedor de interfaz pueda registrar una interfaz.
NdisIfAllocateNetLuidIndex intenta asignar un índice de NET_LUID de 24 bits que es único para el equipo local y está asociado con el tipo de interfaz que especifica el parámetro ifType . NDIS registra el índice NET_LUID en el almacenamiento persistente para que el índice pueda permanecer asociado a la misma interfaz incluso después de reiniciar el equipo. NDIS no asignará el mismo índice de NET_LUID a futuros autores de llamadas de NdisIfAllocateNetLuidIndex hasta después de que el proveedor de interfaz llame a la función NdisIfFreeNetLuidIndex para liberar el índice.
Para crear un valor de NET_LUID a partir del índice NET_LUID y el tipo de interfaz, un proveedor de interfaz llama a la macro NDIS_MAKE_NET_LUID.
El proveedor de interfaz debe almacenar los valores NET_LUID que asigna en el almacenamiento persistente. Por ejemplo, si hay una pérdida de energía del equipo, el proveedor debe haber almacenado los valores de NET_LUID en el almacenamiento persistente para que pueda llamar a NdisIfFreeNetLuidIndex más adelante para liberar los índices que ya no estén en uso. Además, el proveedor debe usar el mismo valor NET_LUID siempre que registre la misma interfaz con el función NdisIfRegisterInterface.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 6.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Interfaces_Function(ndis) |