Função NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)

  • Artigo

Chame a função NdisAdvanceNetBufferListDataStart para liberar o espaço de dados que foi reivindicado em chamadas anteriores para o Função NdisRetreatNetBufferListDataStart .

Sintaxe

NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
  [in] NET_BUFFER_LIST     *NetBufferList,
  [in] ULONG               DataOffsetDelta,
  [in] BOOLEAN             FreeMdl,
       NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);

Parâmetros

[in] NetBufferList

Um ponteiro para uma estrutura de NET_BUFFER_LIST alocada anteriormente.

[in] DataOffsetDelta

A quantidade de espaço de dados usado para liberar.

[in] FreeMdl

Se a memória alocada por TRUE e NDIS atender à chamada NdisRetreatNetBufferListDataStart correspondente, essa função liberará a memória alocada e o MDL associado.

FreeMdlMdlHandler

Um ponto de entrada opcional para uma função NetFreeMdl . Se o chamador especificar um ponto de entrada para a função NetFreeMdl , o NDIS chamará NetFreeMdl para liberar um MDL e memória.

Retornar valor

Nenhum

Comentários

NdisAdvanceNetBufferListDataStart libera espaço de dados usado para todas as estruturas de NET_BUFFER em uma estrutura NET_BUFFER_LIST . Se FreeMdl for TRUE eMemória alocada NdisRetreatNetBufferListDataStart para atender à solicitação de alocação correspondente,
NdisAdvanceNetBufferListDataStart libera a memória alocada. Chamar essa função é equivalente a chamar NdisAdvanceNetBufferDataStart para cada estrutura NET_BUFFER na estrutura NET_BUFFER_LIST. No entanto, chamar NdisAdvanceNetBufferListDataStart é mais eficiente.

Quando os drivers de protocolo chamam NdisAdvanceNetBufferListDataStart no caminho de recebimento para acessar os vários cabeçalhos de transporte, a cadeia de MDL não deve ser modificada e FreeMdl é FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino Universal
Cabeçalho ndis/nblapi.h (inclua ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI Irql_NetBuffer_Function(ndis)

Confira também

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisRetreatNetBufferListDataStart

NetAllocateMdl

NetFreeMdl