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

  • Artigo

Chame a função NdisRetreatNetBufferDataStart para acessar mais espaço de dados usado na cadeia MDL de uma estrutura NET_BUFFER .

Sintaxe

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisRetreatNetBufferDataStart(
  [in]           NET_BUFFER              *NetBuffer,
  [in]           ULONG                   DataOffsetDelta,
  [in]           ULONG                   DataBackFill,
  [in, optional] NET_BUFFER_ALLOCATE_MDL *AllocateMdlHandler
);

Parâmetros

[in] NetBuffer

Um ponteiro para uma estrutura de NET_BUFFER alocada anteriormente.

[in] DataOffsetDelta

A quantidade de espaço de dados usado para adicionar. O NDIS ajusta o membro DataOffset da estrutura NET_BUFFER adequadamente. Se não houver espaço de dados não utilizado suficiente para atender à solicitação, o NDIS alocará memória adicional.

[in] DataBackFill

Se o NDIS precisar alocar memória, esse parâmetro especificará a quantidade de espaço de dados, além do valor do parâmetro DataOffsetDelta , a ser alocado.

[in, optional] AllocateMdlHandler

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

Retornar valor

NdisRetreatNetBufferDataStart retorna um dos seguintes:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
 NdisRetreatNetBufferDataStart alocou com êxito o espaço de dados usado usando o espaço de dados não utilizado ou alocando um novo armazenamento.
NDIS_STATUS_RESOURCES
 NdisRetreatNetBufferDataStart falhou devido a recursos insuficientes.
NDIS_STATUS_FAILURE
 NdisRetreatNetBufferDataStart falhou por motivos diferentes de recursos insuficientes.

Comentários

NdisRetreatNetBufferDataStart tenta atender à solicitação reduzindo o valor do membro DataOffset da estrutura NET_BUFFER .

Se não houver espaço de dados não utilizado suficiente, essa função alocará um novo buffer e um MDL para descrever o novo buffer e encadeia o novo MDL para o início da cadeia de MDL. O NDIS chama a função NetAllocateMdl especificada em AllocateMdl para alocar o MDL e a memória. A função NetAllocateMdl pode usar qualquer método de alocação que atenda aos requisitos de design do driver.

Chamar o Função NdisAdvanceNetBufferDataStart para liberar o espaço de dados usado que foi adicionado com NdisRetreatNetBufferDataStart.

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 da DDI Irql_NetBuffer_Function(ndis)

Confira também

NET_BUFFER

NdisAdvanceNetBufferDataStart

NetAllocateMdl