Función NdisAllocateNetBufferListContext (ndis/nblapi.h)

Artículo
02/07/2025

Llame a la función NdisAllocateNetBufferListContext para asignar más espacio de contexto en la estructura NET_BUFFER_LIST_CONTEXT de un

estructura NET_BUFFER_LIST.

Sintaxis

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisAllocateNetBufferListContext(
  [in] NET_BUFFER_LIST *NetBufferList,
  [in] USHORT          ContextSize,
  [in] USHORT          ContextBackFill,
  [in] ULONG           PoolTag
);

Parámetros

[in] NetBufferList

Puntero a una estructura de NET_BUFFER_LIST asignada previamente.

[in] ContextSize

Cantidad de espacio de contexto que se va a asignar en la estructura NET_BUFFER_LIST_CONTEXT. Esta cantidad debe ser un múltiplo del valor definido por sizeof(void*).

[in] ContextBackFill

Cantidad de memoria, además del valor de ContextSize, para asignar si NDIS debe asignar memoria para satisfacer la solicitud. Esta cantidad debe ser un múltiplo del valor definido por sizeof(void*).

[in] PoolTag

Etiqueta de grupo de kernel que NDIS usa para asignar la memoria para la estructura de NET_BUFFER_LIST_CONTEXT, si se requiere la asignación. La etiqueta es una cadena, delimitada por comillas simples, con hasta cuatro caracteres, normalmente especificada en orden invertido. La etiqueta del grupo de kernel ayuda a NDIS a identificar el propietario de la memoria.

Valor devuelto

NdisAllocateNetBufferListContext devuelve una de las siguientes opciones:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisAllocateNetBufferListContext espacio de contexto asignado correctamente, ya sea reduciendo el valor del miembro Offset de la estructura NET_BUFFER_LIST_CONTEXT o asignando nueva memoria.
NDIS_STATUS_RESOURCES	NdisAllocateNetBufferListContext error debido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisAllocateNetBufferListContext error por motivos distintos de recursos insuficientes.

Observaciones

Si hay suficiente espacio de contexto sin usar disponible en la estructura de NET_BUFFER_LIST_CONTEXT para satisfacer la solicitud, NdisAllocateNetBufferListContext simplemente reduce el valor del miembro Offset en la estructura NET_BUFFER_LIST_CONTEXT. De lo contrario, NDIS asigna nueva memoria para el espacio de contexto. Puede especificar ContextBackFill asignar memoria adicional para que la siguiente llamada a NdisAllocateNetBufferListContext no tenga que asignar memoria.

Nota El espacio de contexto siempre está alineado con "sizeof(void*)". Esta es la alineación adecuada para todos los tipos naturales, pero no es adecuada para los tipos de datos con requisitos de alineación inusuales, como SLIST_ENTRY.

Llamada a función NdisFreeNetBufferListContext para liberar el espacio de contexto en la estructura de NET_BUFFER_LIST_CONTEXT que se asignó con NdisAllocateNetBufferListContext.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis/nblapi.h (incluya ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_NetBuffer_Function(ndis)

Consulte también

NET_BUFFER_LIST

NET_BUFFER_LIST_CONTEXT

NdisFreeNetBufferListContext

Compartir a través de