Función FwpsAllocateNetBufferAndNetBufferList0 (fwpsk.h)

La función FwpsAllocateNetBufferAndNetBufferList0 asigna una nueva estructura de NET_BUFFER_LIST.

NotafwpsAllocateNetBufferAndNetBufferList0 es una versión específica de FwpsAllocateNetBufferAndNetBufferList. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

 

Sintaxis

NTSTATUS FwpsAllocateNetBufferAndNetBufferList0(
  [in]           NDIS_HANDLE     poolHandle,
  [in]           USHORT          contextSize,
  [in]           USHORT          contextBackFill,
  [in, optional] MDL             *mdlChain,
  [in]           ULONG           dataOffset,
  [in]           SIZE_T          dataLength,
  [out]          NET_BUFFER_LIST **netBufferList
);

Parámetros

[in] poolHandle

Identificador de grupo de NET_BUFFER_LIST que se obtuvo de una llamada anterior a la función NdisAllocateNetBufferListPool.

[in] contextSize

Tamaño, en bytes, del espacio de datos usado en la estructura NET_BUFFER_LIST_CONTEXT para reservar para el controlador de llamada. El valor de este parámetro debe ser un múltiplo del valor definido por MEMORY_ALLOCATION_ALIGNMENT.

[in] contextBackFill

Tamaño, en bytes, del espacio de datos sin usar (espacio de reposición) que requiere el controlador de llamada. La función FwpsAllocateNetBufferAndNetBufferList0 agrega este valor al valor especificado en el parámetro ContextSize y asigna espacio adicional. El valor de este parámetro debe ser un múltiplo del valor definido por MEMORY_ALLOCATION_ALIGNMENT.

[in, optional] mdlChain

Puntero a una cadena MDL que se usa para inicializar la estructura de NET_BUFFER previamente asignado. Este parámetro es opcional y se puede NULL.

[in] dataOffset

Desplazamiento inicial, en bytes, desde el inicio del búfer hasta el inicio del espacio de datos usado en la cadena MDL. El espacio de datos delante de este desplazamiento es un espacio de datos sin usar. Por lo tanto, este valor también representa la cantidad inicial de espacio de reposición disponible en la cadena MDL.

[in] dataLength

Longitud, en bytes, del espacio de datos usado en la cadena MDL.

[out] netBufferList

Puntero a una variable que recibe un puntero a la nueva estructura NET_BUFFER_LIST.

Valor devuelto

La función FwpsAllocateNetBufferAndNetBufferList0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La nueva estructura NET_BUFFER_LIST se asignó correctamente.
otros códigos de estado	Error.

Observaciones

Un controlador de llamada llama a la función FwpsAllocateNetBufferAndNetBufferList0 para asignar una nueva estructura de NET_BUFFER_LIST.

Esta función es un contenedor alrededor de función NdisAllocateNetBufferAndNetBufferList, pero está especializada para su uso por las funciones de inyección de paquetes PMA.

Una vez que los datos descritos por la nueva estructura de NET_BUFFER_LIST se han insertado correctamente en la pila de red, el controlador de llamada libera la nueva estructura de NET_BUFFER_LIST llamando a . función FwpsFreeNetBufferList0.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	<= DISPATCH_LEVEL

Consulte también

fwpsFreeNetBufferList0

NET_BUFFER_LIST

NET_BUFFER_LIST_CONTEXT

NdisAllocateNetBufferAndNetBufferList NdisAllocateNetBufferListPool

funciones de inyección de paquetes