Compartir a través de


estructura PD_BUFFER (ndis.h)

Esta estructura representa un paquete PacketDirect (PD) o una parte de un paquete pd en una cola.

Sintaxis

typedef struct _PD_BUFFER {
  struct _PD_BUFFER   *NextPDBuffer;
  struct _PD_BUFFER   *NextPartialPDBuffer;
  PVOID               PDClientReserved;
  PVOID               PDClientContext;
  PUCHAR              DataBufferVirtualAddress;
  DMA_LOGICAL_ADDRESS DataBufferDmaLogicalAddress;
  ULONG               DataBufferSize;
  USHORT              PDClientContextSize;
  USHORT              Attributes;
  USHORT              Flags;
  USHORT              DataStart;
  ULONG               DataLength;
  union {
    struct {
      union {
        ULONG64 RxFilterContext;
        ULONG64 GftFlowEntryId;
      };
      ULONG                         RxHashValue;
      union {
        struct {
          ULONG RxIPHeaderChecksumSucceeded : 1;
          ULONG RxTCPChecksumSucceeded : 1;
          ULONG RxUDPChecksumSucceeded : 1;
          ULONG RxIPHeaderChecksumFailed : 1;
          ULONG RxTCPChecksumFailed : 1;
          ULONG RxUDPChecksumFailed : 1;
          ULONG RxHashComputed : 1;
          ULONG RxHashWithL4PortNumbers : 1;
          ULONG RxGftDirectionIngress : 1;
          ULONG RxGftExceptionPacket : 1;
          ULONG RxGftCopyPacket : 1;
          ULONG RxGftSamplePacket : 1;
          ULONG RxReserved1 : 4;
          ULONG RxCoalescedSegCount : 16;
          ULONG RxRscTcpTimestampDelta;
        };
        ULONG RxOffloads[2];
      };
      union {
        struct {
          ULONG TxIsIPv4 : 1;
          ULONG TxIsIPv6 : 1;
          ULONG TxTransportHeaderOffset : 10;
          ULONG TxMSS : 20;
          ULONG TxComputeIPHeaderChecksum : 1;
          ULONG TxComputeTCPChecksum : 1;
          ULONG TxComputeUDPChecksum : 1;
          ULONG TxIsEncapsulatedPacket : 1;
          ULONG TxInnerPacketOffsetsValid : 1;
          ULONG TxReserved1 : 11;
          ULONG TxInnerFrameOffset : 8;
          ULONG TxInnerIpHeaderRelativeOffset : 6;
          ULONG TxInnerIsIPv6 : 1;
          ULONG TxInnerTcpOptionsPresent : 1;
        };
        ULONG TxOffloads[2];
      };
      PD_BUFFER_VIRTUAL_SUBNET_INFO VirtualSubnetInfo;
      PD_BUFFER_8021Q_INFO          Ieee8021qInfo;
      USHORT                        GftSourceVPortId;
      ULONG                         Reserved;
      UINT64                        ProviderScratch;
    } MetaDataV0;
  };
} PD_BUFFER;

Miembros

NextPDBuffer

Puntero a la siguiente estructura PD_BUFFER de la cola.

NextPartialPDBuffer

Puntero a la siguiente estructura de PD_BUFFER parcial de la cola.

PDClientReserved

Reservado para uso del sistema. No debe usarse.

PDClientContext

El cliente y el proveedor no pueden modificar este campo. Si un cliente ha asignado el PD_BUFFER con un valor distinto de cero para ClientContextSize, PDClientContext hace referencia a un tamaño de búfer de ClientContextSize. De lo contrario, este campo es NULL.

DataBufferVirtualAddress

Este campo representa la dirección que los hosts y el software pueden usar para acceder o modificar el contenido del paquete. Los datos de paquetes reales siempre se encuentra en DataBufferVirtualAddress+DataStart. El proveedor y la plataforma nunca modifican el valor de este campo después de la inicialización del PD_BUFFER .

DataBufferDmaLogicalAddress

Este campo representa la ubicación de memoria lógica utilizada para almacenar los datos del paquete. El proveedor debe usar para DMA. Los datos de paquetes reales siempre se encuentra en DataBufferDmaLogicalAddress+DataStart. El proveedor y la plataforma nunca deben modificar el valor de este campo después de la inicialización PD_BUFFER .

DataBufferSize

Este es el tamaño total del búfer de datos asignado. El proveedor y la plataforma nunca deben modificar el valor de este campo después de la inicialización PD_BUFFER . Este tipo de datos es ULONG en lugar de USHORT debido a una descarga de envío grande.

PDClientContextSize

Cuando este valor es distinto de cero, es el tamaño del búfer al que apunta PDClientContext. La plataforma solo debe modificar el valor de este campo. La plataforma no cambia el valor de este campo después de la asignación de PD_BUFFER .

Attributes

El proveedor nunca debe modificar los atributos. En la tabla siguiente se enumeran los atributos que puede tener esta estructura de PD_BUFFER .

Atributo Descripción
PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER Un PD_BUFFER asignado con su propio búfer de datos adjunto tendrá este conjunto de atributos. Los atributos de PD_BUFFER nunca deben modificarse por clientes o proveedores.

Flags

En la tabla siguiente se enumeran las marcas que puede tener esta estructura de PD_BUFFER .

Marca Descripción
PD_BUFFER_FLAG_PARTIAL_PACKET_HEAD Indica que este búfer es el encabezado de paquetes parciales.

DataStart

Este campo indica dónde comienza el paquete en relación con la dirección inicial original del búfer de datos asignado. El proveedor nunca debe modificar este campo. El proveedor agrega este valor al valor DataBufferDmaLogicalAddress para derivar la dirección DMA de destino real para la recepción o transmisión de paquetes. Por ejemplo, el valor de dirección DMA de destino del descriptor de recepción/transmisión de hardware debe establecerse en DataBufferDmaLogicalAddress+DataStart cuando se publica un PD_BUFFER en una cola de recepción y transmisión.

DataLength

Longitud de los datos de este paquete o de paquetes parciales.

MetaDataV0

MetaDataV0.RxFilterContext

El proveedor establece esto en el valor de contexto de filtro obtenido del filtro coincidente que dirigió el paquete a la cola de recepción. Los clientes especifican los valores de contexto de filtro al configurar filtros.

MetaDataV0.GftFlowEntryId

Si se establece uno de los bits RxGftExceptionPacket o RxGftCopyPacket o RxGftSamplePacket, el valor rxFilterContext se sobrescribe con un valor de identificador de entrada de flujo de GFT.

MetaDataV0.RxHashValue

Valor hash calculado para el paquete entrante que se dirige a la cola de recepción mediante RSS.

MetaDataV0.RxIPHeaderChecksumSucceeded

Campo de descarga de RX común que indica si la suma de comprobación del encabezado IP se realizó correctamente.

MetaDataV0.RxTCPChecksumSucceeded

Campo de descarga de RX común que indica si la suma de comprobación tcp se realizó correctamente.

MetaDataV0.RxUDPChecksumSucceeded

Campo de descarga de RX común que indica si la suma de comprobación de UDP se realizó correctamente.

MetaDataV0.RxIPHeaderChecksumFailed

Campo de descarga de RX común que indica si se produjo un error en la suma de comprobación del encabezado IP.

MetaDataV0.RxTCPChecksumFailed

Campo de descarga de RX común que indica si se produjo un error en la suma de comprobación de TCP.

MetaDataV0.RxUDPChecksumFailed

Campo de descarga de RX común que indica si se produjo un error en la suma de comprobación de UDP.

MetaDataV0.RxHashComputed

Campo de descarga de RX común que indica si se calcula el hash.

MetaDataV0.RxHashWithL4PortNumbers

Un campo de descarga rx común que indica que el hash se calcula con números de puerto L4.

MetaDataV0.RxGftDirectionIngress

MetaDataV0.RxGftExceptionPacket

Un campo de descarga de RX común que indica que se trata de un paquete de excepción GFT.

MetaDataV0.RxGftCopyPacket

Un campo de descarga rx común que indica que se trata de un paquete de copia GFT.

MetaDataV0.RxGftSamplePacket

Un campo de descarga rx común que indica que se trata de un paquete de ejemplo de GFT.

MetaDataV0.RxReserved1

Reservado.

MetaDataV0.RxCoalescedSegCount

Campo de descarga de RX común que contiene la cantidad de segmentos fusionados.

MetaDataV0.RxRscTcpTimestampDelta

Un campo de descarga rx común que contiene la diferencia de marca de tiempo RSC y TCP.

MetaDataV0.RxOffloads[2]

Descargas de RX para este búfer.

MetaDataV0.TxIsIPv4

Un campo de descarga tx común que indica que este paquete es IPv4.

MetaDataV0.TxIsIPv6

Un campo de descarga TX común que indica que este paquete es IPv6.

MetaDataV0.TxTransportHeaderOffset

Campo de descarga tx común que contiene el desplazamiento de encabezado del paquete.

MetaDataV0.TxMSS

Campo de descarga tx común que contiene el tamaño máximo del segmento de este paquete.

MetaDataV0.TxComputeIPHeaderChecksum

Se calcula un campo de descarga tx común que indica que se calcula la suma de comprobación del encabezado IP.

MetaDataV0.TxComputeTCPChecksum

Un campo de descarga tx común que indica que se calcula la suma de comprobación tcp.

MetaDataV0.TxComputeUDPChecksum

Un campo de descarga tx común que indica que se calcula la suma de comprobación udp.

MetaDataV0.TxIsEncapsulatedPacket

Un campo de descarga tx común que indica que el paquete está encapsulado.

MetaDataV0.TxInnerPacketOffsetsValid

Un campo de descarga TX común que indica que los desplazamientos de paquetes internos son válidos.

MetaDataV0.TxReserved1

Reservado.

MetaDataV0.TxInnerFrameOffset

Campo de descarga tx común que contiene el desplazamiento del marco interno.

MetaDataV0.TxInnerIpHeaderRelativeOffset

Campo de descarga tx común que contiene el desplazamiento relativo del encabezado IP interno.

MetaDataV0.TxInnerIsIPv6

Un campo de descarga tx común que indica que el paquete interno es IPv6.

MetaDataV0.TxInnerTcpOptionsPresent

Un campo de descarga tx común que indica que las opciones tcp internas están presentes.

MetaDataV0.TxOffloads[2]

Tx descarga para este búfer.

MetaDataV0.VirtualSubnetInfo

Información de subred virtual.

MetaDataV0.Ieee8021qInfo

La información de IEEE 802.1Q.

MetaDataV0.GftSourceVPortId

Identificador de puerto virtual de origen de GFT.

MetaDataV0.Reserved

Reservado para uso del sistema.

MetaDataV0.ProviderScratch

Campo temporal que el proveedor de PD puede usar para sus propios fines mientras el PD_BUFFER se encuentra en la cola del proveedor (es decir, publicado por el cliente, pero aún no se ha purgado de nuevo por el cliente). Una vez que el cliente purga el PD_BUFFER, no hay ninguna garantía de que se conserve el contenido de este campo.

Comentarios

Si un paquete L2 se representa mediante varias estructuras de PD_BUFFER , el primer PD_BUFFER debe tener establecida la marca PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER y el campo NextPartialPDBuffer debe apuntar a las estructuras de PD_BUFFER parciales que constituyen todo el paquete. Cada una de las estructuras de PD_BUFFER parciales debe apuntar al siguiente PD_BUFFER parcial mediante nextPartialPDBuffer en lugar del campo NextPDBuffer. El campo NextPDBuffer debe ser NULL en todas las estructuras de PD_BUFFER parciales, excepto para el búfer principal. Todas las estructuras de PD_BUFFER parciales, excepto para el búfer principal, deben tener desactivada la marca PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER. El último PD_BUFFER parcial debe tener el campo NextPartialPDBuffer establecido en NULL. La longitud total del paquete L2 es la suma de los campos DataLength de cada PD_BUFFER parcial. La PD_BUFFER principal debe contener hasta e incluir el encabezado de transporte IP (TCP, UDP, SCTP, etc.). En el caso de la encapsulación o la encapsulación doble, el encabezado de transporte IP más interno debe estar contenido en el encabezado PD_BUFFER.

Al publicar PD_BUFFER estructuras para recibir colas, el proveedor omite DataLength (Para obtener más información, consulte la descripción ReceiveDataLength en la estructura NDIS_PD_QUEUE_PARAMETERS ). Cuando se completa la purga PD_BUFFER estructuras de las colas de recepción, el proveedor almacena la longitud del paquete recibido en el campo DataLength. La longitud no incluye FCS ni ningún encabezado 801Q quitado. Al publicar PD_BUFFER estructuras para transmitir colas, DataLength denota la longitud del paquete que se va a enviar. Al purgar las estructuras completadas PD_BUFFER de las colas de transmisión, el proveedor deja sin modificar el campo DataLength.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Encabezado ndis.h