Função NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)
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 para atender à chamada de 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.
Valor de retorno
Nenhum
Observações
versões NdisAdvanceNetBufferListDataStart de espaço de dados usado para todas as estruturas de NET_BUFFER em uma estrutura NET_BUFFER_LIST. Se FreeMdl for VERDADEIRO e
NdisRetreatNetBufferListDataStart memória alocada 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 de 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| da 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) |