Estrutura NET_BUFFER

NDIS 6.0 e posterior NET_BUFFER estruturas são análogas às estruturas de NDIS_PACKET usadas pelo NDIS 5. x e drivers anteriores. Cada estrutura NET_BUFFER empacota um pacote de dados de rede.

A figura a seguir mostra os campos em uma estrutura NET_BUFFER.

A estrutura NET_BUFFER inclui uma estrutura NET_BUFFER_HEADER no membro NetBufferHeader . A estrutura NET_BUFFER_HEADER inclui uma estrutura NET_BUFFER_DATA no membro NetBufferData . Você deve usar macros NDIS para acessar NET_BUFFER membros da estrutura. Para obter uma lista completa dessas macros, consulte a página de referência da estrutura NET_BUFFER .

Alguns dos membros da estrutura NET_BUFFER são usados apenas pelo NDIS. Os membros que os drivers normalmente usam são:

ProtocolReserved
Reservado para uso por drivers de protocolo.

MiniportReserved
Reservado para uso por drivers de miniporta.

NdisPoolHandle
Especifica um identificador de pool que identifica o pool de NET_BUFFER do qual a estrutura de NET_BUFFER foi alocada.

Próximo
Especifica um ponteiro para a próxima estrutura NET_BUFFER em uma lista vinculada de estruturas de NET_BUFFER. Se esta for a última estrutura NET_BUFFER na lista, esse membro será NULL.

Datalength
Especifica o comprimento em bytes dos dados de rede na cadeia de MDL.

Dataoffset
Especifica o deslocamento, em bytes, desde o início da memória na cadeia MDL até o início dos dados de rede na cadeia de MDL.

CurrentMdl
Especifica um ponteiro para o primeiro MDL que o driver atual está usando. Esse ponteiro fornece uma otimização que melhora o desempenho ignorando quaisquer MDLs que o driver atual não está usando.

CurrentMdlOffset
Especifica o deslocamento, em bytes, até o início do espaço de dados usado no MDL especificado pelo membro CurrentMdl da estrutura NET_BUFFER.

A figura a seguir mostra a relação entre os membros CurrentMdl, CurrentMdlOffset, DataOffset e DataLength e o espaço de dados.

O NDIS fornece funções para gerenciar o espaço de dados na cadeia de MDL. Como os drivers usam o espaço de dados muda dinamicamente com o driver atual. Às vezes, há espaço de dados que atualmente não é usado pelo driver atual. Embora o espaço de dados não utilizado não esteja em uso no momento, ele pode conter dados válidos. Por exemplo, no caminho de recebimento, o espaço de dados não utilizado pode conter informações de cabeçalho que foram usadas por um driver de nível inferior.

Os drivers executam operações de retirada e avanço para aumentar e diminuir o espaço de dados usado. Para obter mais informações sobre operações de retirada e avanço, consulte Operações de retirada e avanço.

Os seguintes termos e definições descrevem elementos do espaço de dados NET_BUFFER :

Espaço de dados usado
O espaço de dados usado contém dados que o driver atual está usando no momento atual. Os drivers aumentam o espaço de dados usado com operações de retirada e reduzem o espaço de dados usado com operações avançadas.

Espaço de dados não utilizado
O driver atual não está usando esse espaço de dados no momento atual.

Tamanho total dos dados
O tamanho total dos dados é a soma do tamanho do espaço de dados usado e do espaço de dados não utilizado. Para calcular o tamanho total, adicione o DataOffset ao DataLength .

Retiro
As operações de retirada aumentam o tamanho do espaço de dados usado.

Antecedência
As operações avançadas diminuem o tamanho do espaço de dados usado.