Função MmAllocateContiguousMemory (wdm.h)
A rotina MmAllocateContiguousMemory aloca uma variedade de memória física contígua e nãopagada e a mapeia para o espaço de endereço do sistema.
Sintaxe
PVOID MmAllocateContiguousMemory(
[in] SIZE_T NumberOfBytes,
[in] PHYSICAL_ADDRESS HighestAcceptableAddress
);
Parâmetros
[in] NumberOfBytes
O tamanho, em bytes, do bloco de memória contígua a ser alocado. Para obter mais informações, consulte Comentários.
[in] HighestAcceptableAddress
O endereço físico mais alto válido que o chamador pode usar. Por exemplo, se um dispositivo puder abordar apenas os locais nos primeiros 16 megabytes do intervalo de endereços de memória física do processador, o driver deste dispositivo deverá definir HighestAcceptableAddress como 0x0000000000FFFFFF. Se você não tiver requisitos específicos para alocação de memória, defina como MAXULONG64.
Retornar valor
MmAllocateContiguousMemory retorna o endereço virtual base para a memória alocada. Se a solicitação não puder ser atendida, a rotina retornará NULL.
Comentários
MmAllocateContiguousMemory aloca um bloco de memória nãopagada contíguo no espaço de endereço físico. A rotina mapeia esse bloco para um bloco contíguo de memória virtual no espaço de endereço do sistema e retorna o endereço virtual da base desse bloco. A rotina alinha o endereço inicial de uma alocação de memória contígua a um limite de página de memória.
Os drivers não devem acessar a memória além do tamanho de alocação solicitado. Por exemplo, os desenvolvedores não devem assumir que seus drivers podem usar a memória com segurança entre o final da alocação solicitada e o limite da próxima página.
Como a memória física contígua geralmente está em falta, ela deve ser usada com moderação e somente quando necessário. Um driver que deve usar memória contígua deve alocar essa memória durante a inicialização do driver porque a memória física provavelmente ficará fragmentada ao longo do tempo à medida que o sistema operacional aloca e libera memória. Normalmente, um driver chama MmAllocateContiguousMemory de sua rotina DriverEntry para alocar um buffer interno para uso de longo prazo e libera o buffer pouco antes de o driver ser descarregado.
A memória alocada por MmAllocateContiguousMemory deve ser liberada quando a memória não for mais necessária. Chame a rotina MmFreeContiguousMemory para liberar memória alocada por MmAllocateContiguousMemory.
Quando a memória física é fragmentada em um computador que tem uma grande quantidade de RAM, as chamadas para MmAllocateContiguousMemory, que exigem que o sistema operacional pesquise blocos contíguos de memória, podem prejudicar severamente o desempenho. Essa degradação é muito reduzida a partir do Windows Vista SP1 e do Windows Server 2008, mas a memória contígua ainda pode ser cara para alocar. Por esse motivo, os drivers devem evitar chamadas repetidas para MmAllocateContiguousMemory. Em vez disso, os drivers devem alocar todos os buffers contíguos necessários em suas rotinas driverEntry e reutilizar esses buffers.
A memória alocada por MmAllocateContiguousMemory não está inicializada. Um driver de modo kernel deve primeiro definir essa memória como zero se ela for torná-la visível para o software do modo de usuário (para evitar vazamento de conteúdo potencialmente privilegiado).
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (inclua Wdm.h, Ntddk.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | IRQL <= DISPATCH_LEVEL |