NET_BUFFER_LIST Estrutura

Uma estrutura NET_BUFFER_LIST empacota uma lista vinculada de estruturas NET_BUFFER.

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

A estrutura NET_BUFFER_LIST inclui uma estrutura NET_BUFFER_LIST_HEADER no membro NetBufferListHeader. A estrutura NET_BUFFER_LIST_HEADER inclui uma estrutura NET_BUFFER_LIST_DATA no membro NetBufferListData. Você deve usar macros NDIS para acessar os membros da estrutura NET_BUFFER_LIST. Para obter mais informações sobre essas macros, consulte a página de referência de estrutura NET_BUFFER_LIST.

Alguns dos membros são usados apenas pelo NDIS. Os membros que os drivers são mais propensos a usar são definidos na lista a seguir:

ParentNetBufferList
Se uma estrutura NET_BUFFER_LIST for um elemento derivado de uma estrutura principal (clonado, fragmentado ou remontado), ParentNetBufferList especifica um ponteiro para a estrutura NET_BUFFER_LIST principal. Caso contrário, esse parâmetro é NULL.

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

ProtocolReserved
Reservado para uso por controladores de protocolo.

MiniportReservado
Reservado para uso por drivers de miniporta.

SourceHandle
Um manipulador que o NDIS forneceu ao controlador numa operação de ligação ou anexação usando uma das seguintes rotinas fornecidas pelo controlador:

Driver Miniport
MiniportInitializeEx

Driver de protocolo
ProtocolBindAdapterEx

Driver de filtro
FilterAttach

O NDIS usa SourceHandle para devolver a estrutura NET_BUFFER_LIST ao driver que enviou a estrutura NET_BUFFER_LIST. Os drivers NDIS não devem ler este manípulo.

ChildRefCount
Se uma estrutura NET_BUFFER_LIST for pai (tiver filhos derivados de operações de clone, fragmento ou reagregação), ChildRefCount especifica o número de filhos existentes. Caso contrário, esse parâmetro será zero.

Bandeiras
Reservado para futura especificação de atributos para a estrutura NET_BUFFER_LIST. Atualmente, não há bandeiras disponíveis para os motoristas.

Status
Especifica o status de conclusão final de uma operação de dados de rede para essa estrutura de NET_BUFFER_LIST. Os drivers de miniporta gravam esse valor antes de concluir uma operação de envio.

NetBufferListInfo
Especifica informação de estrutura NET_BUFFER_LIST que são comuns a todas as estruturas NET_BUFFER na lista. Essas informações são frequentemente chamadas de "dados fora de banda (OOB)".

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

FirstNetBuffer
Especifica um ponteiro para a primeira estrutura NET_BUFFER numa lista encadeada de estruturas NET_BUFFER associadas a essa estrutura NET_BUFFER_LIST.

Observação de contexto é um ponteiro para uma estrutura NET_BUFFER_LIST_CONTEXT. NDIS fornece macros e funções para manipular os dados em Context . Para obter mais informações sobre a estrutura NET_BUFFER_LIST_CONTEXT, consulte NET_BUFFER_LIST_CONTEXT Structure.