Partilhar via


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

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 no tamanho solicitado.

Valor de retorno

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

Observações

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.

Chamadas NDIS NetAllocateMdl no IRQL <= DISPATCH_LEVEL.

Requisitos

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

Consulte também

NdisRetreatNetBufferDataStart

NetFreeMdl