Função ExAllocatePoolWithQuota (wdm.h)
Aviso
A rotina ExAllocatePoolWithQuota está obsoleta e foi preterida em Windows 10, versão 2004 e foi substituída por ExAllocatePool2. Para obter mais informações, consulte Atualizando chamadas de ExAllocatePool preteridas para ExAllocatePool2 e ExAllocatePool3.
Ao desenvolver drivers para a versão do Windows antes do Windows 10, versão 2004, use ExAllocatePoolQuotaZero.
ExAllocatePoolWithQuota aloca memória do pool, cobrando cota no processo atual.
Sintaxe
PVOID ExAllocatePoolWithQuota(
[in] __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
[in] SIZE_T NumberOfBytes
);
Parâmetros
[in] PoolType
Especifica o tipo de memória do pool a ser alocada. Para obter uma descrição dos tipos de memória do pool disponíveis, consulte POOL_TYPE.
Você pode modificar PoolType usando um OR bit a bit com o sinalizador POOL_COLD_ALLOCATION como uma dica para o kernel para alocar a memória de páginas que provavelmente serão paginada rapidamente. Para reduzir a quantidade de memória do pool residente o máximo possível, você não deve referenciar essas alocações com frequência. O sinalizador POOL_COLD_ALLOCATION é apenas aviso e está disponível para o Windows XP e versões posteriores do sistema operacional Windows.
[in] NumberOfBytes
Especifica o número de bytes para alocar.
Retornar valor
ExAllocatePoolWithQuota retorna um ponteiro para o pool alocado.
Se a solicitação não puder ser atendida, ExAllocatePoolWithQuota gerará uma exceção.
Comentários
Essa rotina é chamada por drivers de nível mais alto que alocam memória para atender a uma solicitação no contexto do processo que originalmente fez a solicitação de E/S. Em vez disso, os drivers de nível inferior chamam ExAllocatePoolWithTag .
Se NumberOfBytes for PAGE_SIZE ou superior, um buffer alinhado à página será alocado. A cota não é cobrada no processo por alocações de PAGE_SIZE ou superior.
Alocações de memória de menos de PAGE_SIZE são alocadas em uma página e não cruzam limites de página. As alocações de memória de PAGE_SIZE ou menos não são necessariamente alinhadas à página, mas estão alinhadas aos limites de 8 bytes em sistemas de 32 bits e aos limites de 16 bytes em sistemas de 64 bits.
Não defina NumberOfBytes = 0. Evite alocações de comprimento zero porque elas desperdiçam espaço de cabeçalho do pool e, em muitos casos, indicam um possível problema de validação no código de chamada. Por esse motivo, o Verificador de Driver sinaliza essas alocações como possíveis erros.
O sistema define automaticamente determinados objetos de evento padrão quando a quantidade de pool (paginada ou não paga) é alta ou baixa. Os drivers podem aguardar esses eventos ajustarem o uso do pool. Para obter mais informações, consulte Objetos de evento padrão.
A memória alocada por ExAllocatePoolWithQuota não é inicializada. Um driver de modo kernel deve primeiro zero essa memória se ele vai torná-lo visível para o software no modo de usuário (para evitar o vazamento de conteúdo potencialmente privilegiado).
Os chamadores de ExAllocatePoolWithQuota devem estar em execução em IRQL <= DISPATCH_LEVEL. Um chamador em execução no DISPATCH_LEVEL deve especificar um valor XxxNãoPaged para PoolType. Um chamador em execução em IRQL <= APC_LEVEL pode especificar qualquer valor de POOL_TYPE , mas o IRQL e o ambiente também devem ser considerados para determinar o tipo de pool.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Obsoleto. Essa rotina é exportada apenas para binários de driver existentes. Em vez disso, use ExAllocatePoolWithQuotaTag. |
Plataforma de Destino | Universal |
Cabeçalho | wdm.h (incluem Wdm.h, Ntddk.h, Ntifs.h, Classpnp.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL (consulte a seção Comentários) |
Regras de conformidade da DDI | HwStorPortProhibitedDIs(storport), SpNoWait(storport), StorPortStartIo(storport), UnsafeAllocatePool(kmdf) |