Função FltAllocatePoolAlignedWithTag (fltkernel.h)

FltAllocatePoolAlignedWithTag aloca um buffer alinhado ao dispositivo para uso em uma operação de E/S não armazenada em cache.

Sintaxe

PVOID FLTAPI FltAllocatePoolAlignedWithTag(
  [in] PFLT_INSTANCE Instance,
  [in] POOL_TYPE     PoolType,
  [in] SIZE_T        NumberOfBytes,
  [in] ULONG         Tag
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para uma instância de driver de minifiltro de propriedade do chamador que está anexada ao volume. Esse parâmetro é necessário e não pode ser NULL.

[in] PoolType

Tipo de pool a ser alocado. Um dos seguintes:

NonPagedPool

PagedPool

NonPagedPoolCacheAligned

PagedPoolCacheAligned

Consulte POOL_TYPE para obter uma descrição dos tipos de memória do pool disponíveis.

[in] NumberOfBytes

Número de bytes a serem alocados. Esse parâmetro é necessário e pode ser zero.

[in] Tag

Especifica a marca de pool para a memória alocada. Os drivers normalmente especificam a marca de pool como uma cadeia de caracteres de um a quatro caracteres ASCII de 7 bits, delimitadas por aspas simples (por exemplo, 'abcd'). Esse parâmetro é necessário e não pode ser zero.

Retornar valor

Se não houver pool livre suficiente disponível para atender à solicitação, FltAllocatePoolAlignedWithTag retornará um ponteiro NULL . Caso contrário, FltAllocatePoolAlignedWithTag retornará um ponteiro para o buffer recém-alocado.

Comentários

FltAllocatePoolAlignedWithTag aloca um buffer alinhado de acordo com o dispositivo subjacente para o volume fornecido. Esses buffers alinhados ao dispositivo são necessários para E/S não armazenada em cache. (Eles também podem ser usados para E/S armazenada em cache.) Assim, ao chamar rotinas que executam E/S não cache, como FltReadFile e FltWriteFile, os drivers de minifiltro devem chamar FltAllocatePoolAlignedWithTag em vez de ExAllocatePoolWithTag.

Se o chamador especificar um valor zero para o parâmetro NumberOfBytes , FltAllocatePoolAlignedWithTag alocará a menor quantidade de memória que atende ao requisito de alinhamento.

O sistema associa a marca de pool especificada pelo parâmetro Tag ao buffer alocado. Ferramentas de programação, como o WinDbg (Depurador do Windows), podem exibir a marca de pool associada a cada buffer alocado. O valor da marca de pool normalmente é exibido em ordem invertida. Por exemplo, se um chamador passar 'Fred' como o valor do parâmetro Tag , esse valor aparecerá como 'derF' se o pool for despejado ou ao rastrear o uso do pool no depurador.

Para obter mais informações sobre o gerenciamento de memória, consulte Gerenciamento de memória.

Quando o buffer alocado por FltAllocatePoolAlignedWithTag não é mais necessário, o chamador é responsável por liberá-lo chamando FltFreePoolAlignedWithTag.

Os chamadores de FltAllocatePoolAlignedWithTag só poderão ser executados no IRQL DISPATCH_LEVEL se umXxxPoolType NãoPaged for especificado. Caso contrário, os chamadores devem estar em execução em IRQL <= APC_LEVEL.

Requisitos

Confira também

ExAllocatePoolWithTag

FltFreePoolAlignedWithTag

FltReadFile

FltWriteFile