Función NdisAllocateCloneNetBufferList (ndis/nblapi.h)

Artículo
08/07/2023

Llame a la función NdisAllocateCloneNetBufferList para crear una nueva estructura de NET_BUFFER_LIST clonada.

Sintaxis

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateCloneNetBufferList(
  [in]           NET_BUFFER_LIST *OriginalNetBufferList,
  [in, optional] NDIS_HANDLE     NetBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     NetBufferPoolHandle,
  [in]           ULONG           AllocateCloneFlags
);

Parámetros

[in] OriginalNetBufferList

Puntero a una estructura de NET_BUFFER_LIST existente.

[in, optional] NetBufferListPoolHandle

Identificador obtenido de una llamada a . Función NdisAllocateNetBufferListPool .

[in, optional] NetBufferPoolHandle

Identificador de grupo de NET_BUFFER estructura que se devolvió anteriormente desde una llamada a NdisAllocateNetBufferPool.

[in] AllocateCloneFlags

Marcas NDIS que se pueden combinar con una operación OR. Se definen las marcas siguientes:

NDIS_CLONE_FLAGS_RESERVED

Reservado para NDIS.

NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS

Si se establece esta marca, NDIS no asigna nuevos MDL para el NET_BUFFER_LIST clonado. En su lugar, el NET_BUFFER_LIST clonado usa la misma cadena MDL que el NET_BUFFER_LIST original. Si se borra NDIS_CLONE_FLAGS_USE_ORIGINAL_MDLS, NDIS asigna nuevos MDL para hacer referencia a los búferes de datos originales.

Valor devuelto

NdisAllocateCloneNetBufferList devuelve un puntero a la nueva estructura de NET_BUFFER_LIST clonación. Si la asignación no se realizó correctamente, este puntero es NULL.

Comentarios

Llame a NdisAllocateCloneNetBufferList para crear una estructura de NET_BUFFER_LIST clonada que puede usar para enviar datos duplicados en una ruta de acceso de datos independiente.

Cada estructura NET_BUFFER de la estructura de NET_BUFFER_LIST original solo se clona desde el principio del espacio de datos usado, no desde el inicio del espacio de datos completo. Para obtener el desplazamiento desde el principio del espacio de datos hasta el inicio del espacio de datos usado, use la macro NET_BUFFER_DATA_OFFSET .

Si la estructura de NET_BUFFER_LIST clonada debe tener atributos asociados a un grupo determinado, el autor de la llamada debe especificar el identificador del grupo en el parámetro NetBufferListPoolHandle o NetBufferPoolHandle . Por ejemplo, el miembro ProtocolType de la estructura NET_BUFFER_LIST está asociado al grupo.

La estructura de NET_BUFFER_LIST clonada describe los mismos datos descritos por la estructura de NET_BUFFER_LIST en OriginalNetBufferList. NDIS no copia los datos descritos por los MDL originales en nuevos búferes de datos. En su lugar, las estructuras clonadas hacen referencia a los búferes de datos originales. La estructura de NET_BUFFER_LIST clonada no incluye una inicial NET_BUFFER_LIST_CONTEXT estructura.

Llamar a Función NdisFreeCloneNetBufferList para liberar una estructura de NET_BUFFER_LIST y todas las estructuras asociadas y cadenas MDL asignadas mediante una llamada a NdisAllocateCloneNetBufferList.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	ndis/nblapi.h (include ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_NetBuffer_Function(ndis), NdisAllocateCloneNetBufferList(ndis), NdisAllocateCloneNetBufferList_InitFail(ndis)