função de retorno de chamada NET_BUFFER_ALLOCATE_MDL (nblapi.h)

  • Artigo

A função NetAllocateMdl aloca um MDL com um bloco de memória associado de um tamanho especificado.

Sintaxe

NET_BUFFER_ALLOCATE_MDL NetBufferAllocateMdl;

MDL * NetBufferAllocateMdl(
  [in] ULONG *BufferSize
)
{...}

Parâmetros

[in] BufferSize

O tamanho do bloco de memória, em bytes. Ao chamar NetAllocateMdl, o NDIS passa o tamanho solicitado.

Retornar valor

NetAllocateMdl retorna um ponteiro para o MDL alocado. Se a alocação falhar, o valor retornado será NULL.

Comentários

Se o driver NDIS especificar um ponto de entrada para a função NetAllocateMdl no parâmetro AllocateMdl do Função NdisRetreatNetBufferDataStart , o NDIS chama NetAllocateMdl para alocar um MDL e memória.

O NDIS especifica o tamanho do bloco de memória associado em BufferSize .

NetAllocateMdl pode usar qualquer método de alocação que atenda aos requisitos de design do driver. Quando o NDIS chama a função NetFreeMdl para liberar a memória, o driver NDIS deve liberar a memória usando o mesmo mecanismo de gerenciamento de memória usado para alocar a memória.

O NDIS chama NetAllocateMdl em IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Cabeçalho nblapi.h (inclua ndis.h)
IRQL <= DISPATCH_LEVEL

Confira também

NdisRetreatNetBufferDataStart

NetFreeMdl