Compartilhar via


estrutura PD_BUFFER (ndis.h)

Essa estrutura representa um pacote PD (PacketDirect) ou uma parte de um pacote PD em uma fila.

Sintaxe

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;

Membros

NextPDBuffer

Um ponteiro para a próxima estrutura PD_BUFFER na fila.

NextPartialPDBuffer

Um ponteiro para a próxima estrutura de PD_BUFFER parcial na fila.

PDClientReserved

Reservado para uso do sistema. Não use.

PDClientContext

O cliente e o provedor não têm permissão para modificar esse campo. Se um cliente tiver alocado o PD_BUFFER com um valor diferente de zero para ClientContextSize, o PDClientContext se referirá a um tamanho de buffer de ClientContextSize. Caso contrário, esse campo será NULL.

DataBufferVirtualAddress

Esse campo representa o endereço que os hosts e o software podem usar para acessar/modificar o conteúdo do pacote. Os dados reais do pacote estão sempre em DataBufferVirtualAddress+DataStart. O provedor e a plataforma nunca modificam o valor desse campo após a inicialização do PD_BUFFER .

DataBufferDmaLogicalAddress

Esse campo representa o local de memória lógica usado para armazenar os dados do pacote. O provedor deve usar para DMA. Os dados reais do pacote estão sempre em DataBufferDmaLogicalAddress+DataStart. O provedor e a plataforma nunca devem modificar o valor desse campo após a inicialização do PD_BUFFER .

DataBufferSize

Esse é o tamanho total do buffer de dados alocado. O provedor e a plataforma nunca devem modificar o valor desse campo após a inicialização do PD_BUFFER . Esse tipo de dados é ULONG em vez de USHORT devido ao descarregamento de envio grande.

PDClientContextSize

Quando esse valor é diferente de zero, ele é o tamanho do buffer apontado por PDClientContext. O valor desse campo só deve ser modificado pela plataforma. A plataforma não altera o valor desse campo após a alocação PD_BUFFER .

Attributes

Os atributos nunca devem ser modificados pelo provedor. A tabela a seguir lista os atributos que essa estrutura PD_BUFFER pode ter.

Atributo Descrição
PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER Um PD_BUFFER alocado com seu próprio buffer de dados que acompanha terá esse atributo definido. Os atributos PD_BUFFER nunca devem ser modificados por clientes ou provedores.

Flags

A tabela a seguir lista os sinalizadores que essa estrutura PD_BUFFER pode ter.

Sinalizador Descrição
PD_BUFFER_FLAG_PARTIAL_PACKET_HEAD Indica que esse buffer é o cabeçalho de pacotes parciais.

DataStart

Esse campo indica onde o pacote começa em relação ao endereço inicial original do buffer de dados alocado. O provedor nunca deve modificar esse campo. O provedor adiciona esse valor ao valor DataBufferDmaLogicalAddress para derivar o endereço DMA de destino real para recepção/transmissão de pacotes. Por exemplo, o valor de endereço DMA de destino no descritor de recebimento/transmissão de hardware deve ser definido como DataBufferDmaLogicalAddress+DataStart quando um PD_BUFFER é postado em uma fila de recebimento/transmissão.

DataLength

O comprimento desse pacote ou dos dados parciais do pacote.

MetaDataV0

MetaDataV0.RxFilterContext

O provedor define isso como o valor de contexto de filtro obtido do filtro correspondente que guiou o pacote para a fila de recebimento. Os valores de contexto de filtro são especificados pelos clientes ao configurar filtros.

MetaDataV0.GftFlowEntryId

Se um dos bits RxGftExceptionPacket ou RxGftCopyPacket ou RxGftSamplePacket for definido, o valor RxFilterContext será substituído por um valor de ID de entrada de fluxo GFT.

MetaDataV0.RxHashValue

O valor de hash calculado para o pacote de entrada que é direcionado para a fila de recebimento usando RSS.

MetaDataV0.RxIPHeaderChecksumSucceeded

Um campo de descarregamento RX comum que indica se a soma de verificação do cabeçalho IP foi bem-sucedida.

MetaDataV0.RxTCPChecksumSucceeded

Um campo de descarregamento RX comum que indica se a soma de verificação TCP foi bem-sucedida.

MetaDataV0.RxUDPChecksumSucceeded

Um campo de descarregamento RX comum que indica se a soma de verificação UDP foi bem-sucedida.

MetaDataV0.RxIPHeaderChecksumFailed

Um campo de descarregamento RX comum que indica se a soma de verificação do cabeçalho IP falhou.

MetaDataV0.RxTCPChecksumFailed

Um campo de descarregamento RX comum que indica se a soma de verificação TCP falhou.

MetaDataV0.RxUDPChecksumFailed

Um campo de descarregamento RX comum que indica se a soma de verificação UDP falhou.

MetaDataV0.RxHashComputed

Um campo de descarregamento RX comum que indica se o hash é calculado.

MetaDataV0.RxHashWithL4PortNumbers

Um campo de descarregamento RX comum que indica que o hash é calculado com números de porta L4.

MetaDataV0.RxGftDirectionIngress

MetaDataV0.RxGftExceptionPacket

Um campo de descarregamento RX comum que indica que se trata de um pacote de exceção de GFT.

MetaDataV0.RxGftCopyPacket

Um campo de descarregamento RX comum que indica que se trata de um pacote de cópia GFT.

MetaDataV0.RxGftSamplePacket

Um campo de descarregamento RX comum que indica que se trata de um pacote de exemplo de GFT.

MetaDataV0.RxReserved1

Reservado.

MetaDataV0.RxCoalescedSegCount

Um campo de descarregamento RX comum que contém a quantidade de segmentos unidos.

MetaDataV0.RxRscTcpTimestampDelta

Um campo de descarregamento RX comum que contém diferença de carimbo de data/hora RSC e TCP.

MetaDataV0.RxOffloads[2]

Descarregamentos RX para esse buffer.

MetaDataV0.TxIsIPv4

Um campo de descarregamento TX comum que indica que esse pacote é IPv4.

MetaDataV0.TxIsIPv6

Um campo de descarregamento TX comum que indica que esse pacote é IPv6.

MetaDataV0.TxTransportHeaderOffset

Um campo de descarregamento TX comum que contém o deslocamento de cabeçalho do pacote.

MetaDataV0.TxMSS

Um campo de descarregamento TX comum que contém o tamanho máximo do segmento desse pacote.

MetaDataV0.TxComputeIPHeaderChecksum

Um campo de descarregamento TX comum que indica que a soma de verificação do cabeçalho IP é calculada.

MetaDataV0.TxComputeTCPChecksum

Um campo de descarregamento TX comum que indica que a soma de verificação TCP é calculada.

MetaDataV0.TxComputeUDPChecksum

Um campo de descarregamento TX comum que indica que a soma de verificação UDP é calculada.

MetaDataV0.TxIsEncapsulatedPacket

Um campo de descarregamento TX comum que indica que o pacote está encapsulado.

MetaDataV0.TxInnerPacketOffsetsValid

Um campo de descarregamento TX comum que indica que os deslocamentos de pacote interno são válidos.

MetaDataV0.TxReserved1

Reservado.

MetaDataV0.TxInnerFrameOffset

Um campo de descarregamento TX comum que contém o deslocamento de quadro interno.

MetaDataV0.TxInnerIpHeaderRelativeOffset

Um campo de descarregamento TX comum que contém o deslocamento relativo do cabeçalho IP interno.

MetaDataV0.TxInnerIsIPv6

Um campo de descarregamento TX comum que indica que o pacote interno é IPv6.

MetaDataV0.TxInnerTcpOptionsPresent

Um campo de descarregamento TX comum que indica que as opções internas de TCP estão presentes.

MetaDataV0.TxOffloads[2]

Descarregamentos TX para esse buffer.

MetaDataV0.VirtualSubnetInfo

As informações da sub-rede virtual.

MetaDataV0.Ieee8021qInfo

As informações do IEEE 802.1Q.

MetaDataV0.GftSourceVPortId

A ID da porta virtual de origem GFT.

MetaDataV0.Reserved

Reservado para uso do sistema.

MetaDataV0.ProviderScratch

Um campo de rascunho que o provedor de PD pode usar para suas próprias finalidades enquanto o PD_BUFFER está na fila do provedor (em outras palavras, postado pelo cliente, mas ainda não esvaziado pelo cliente). Depois que o PD_BUFFER for esvaziado pelo cliente, não haverá garantia de que o conteúdo desse campo será preservado.

Comentários

Se um pacote L2 for representado por várias estruturas PD_BUFFER , o primeiro PD_BUFFER deverá ter o sinalizador PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER definido e o campo NextPartialPDBuffer deverá apontar para as estruturas parciais PD_BUFFER que constituem o pacote inteiro. Cada uma das estruturas de PD_BUFFER parciais deve apontar para a próxima PD_BUFFER parcial usando o campo NextPartialPDBuffer em vez do campo NextPDBuffer. O campo NextPDBuffer deve ser NULL em todas as estruturas de PD_BUFFER parciais, exceto no buffer principal. Todas as estruturas de PD_BUFFER parciais, exceto o buffer de cabeçalho, devem ter o sinalizador PD_BUFFER_ATTR_BUILT_IN_DATA_BUFFER limpo. A última PD_BUFFER parcial deve ter seu campo NextPartialPDBuffer definido como NULL. O comprimento total do pacote L2 é a soma dos campos DataLength de cada PD_BUFFER parcial. O cabeçalho PD_BUFFER deve conter até e incluindo o cabeçalho de transporte IP (TCP, UDP, SCTP etc.). No caso de encapsulamento ou encapsulamento duplo, o cabeçalho de transporte IP mais interno deve estar contido no cabeçalho PD_BUFFER.

Ao postar PD_BUFFER estruturas para receber filas, o DataLength é ignorado pelo provedor (para obter mais informações, consulte a descrição ReceiveDataLength na estrutura NDIS_PD_QUEUE_PARAMETERS ). Ao esvaziar estruturas PD_BUFFER concluídas de filas de recebimento, o provedor armazena o comprimento do pacote recebido no campo DataLength. O comprimento não inclui FCS ou cabeçalhos 801Q removidos. Ao postar PD_BUFFER estruturas para transmitir filas, o DataLength indica o comprimento do pacote a ser enviado. Ao esvaziar estruturas PD_BUFFER concluídas de filas de transmissão, o provedor deixa o campo DataLength inalterado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Cabeçalho ndis.h