Partilhar via


Função MmAllocateMappingAddress (wdm.h)

A rotina MmAllocateMappingAddress reserva um intervalo de espaço de endereço virtual do sistema do tamanho especificado.

Sintaxe

PVOID MmAllocateMappingAddress(
  [in] SIZE_T NumberOfBytes,
  [in] ULONG  PoolTag
);

Parâmetros

[in] NumberOfBytes

Especifica o número de bytes a serem reservados.

[in] PoolTag

Especifica uma marca de quatro caracteres usada para identificar o buffer. Use uma marca poolTag distinta para cada caminho de código de alocação. Para obter uma descrição das marcas de pool, consulte ExAllocatePoolWithTag.

Valor de retorno

MmAllocateMappingAddress retorna um ponteiro para o início do buffer de memória reservado.

Observações

MmAllocateMappingAddress reserva um intervalo de endereços virtuais do sistema para o chamador usar. Nenhuma memória física é alocada para o intervalo de endereços virtuais e a memória virtual não pode ser acessada até que seja mapeada pela rotina de MmMapLockedPagesWithReservedMapping. O chamador cancela o intervalo de memória reservado chamando a rotina MmUnmapReservedMapping. Por fim, o chamador pode liberar o intervalo reservado chamando MmFreeMappingAddress.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows XP e versões posteriores do Windows.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <=APC_LEVEL

Consulte também

MmFreeMappingAddress

MmMapLockedPagesWithReservedMapping

MmUnmapReservedMapping