função de retorno de chamada NET_BUFFER_ALLOCATE_MDL (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 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 |