Função VideoPortAllocatePool (video.h)

A função VideoPortAllocatePool aloca um bloco de memória do pool, inserindo uma marca fornecida pelo chamador no início da memória.

Sintaxe

VIDEOPORT_API PVOID VideoPortAllocatePool(
  [in] IN PVOID        HwDeviceExtension,
  [in] IN VP_POOL_TYPE PoolType,
  [in] IN SIZE_T       NumberOfBytes,
  [in] IN ULONG        Tag
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão de dispositivo do driver de miniport.

[in] PoolType

Especifica o tipo de pool de memória a ser alocado. Esse parâmetro pode ser definido como um dos seguintes:

[in] NumberOfBytes

Especifica o número de bytes de memória a serem alocados.

[in] Tag

Especifica uma marca de alocação de quatro bytes, que consiste em até quatro caracteres ASCII, que identifica exclusivamente o driver que está alocando a memória. A cadeia de caracteres de marca é delimitada com aspas simples.

Retornar valor

Na alocação bem-sucedida do pool de memória, VideoPortAllocatePool retorna o endereço do pool de memória alocado. Caso contrário, essa função retornará NULL.

Comentários

VideoPortAllocatePool destina-se a substituir VideoPortAllocateBuffer, que está obsoleto.

A cadeia de caracteres Tag deve ser especificada em ordem invertida por bytes. É recomendável que a primeira letra na cadeia de caracteres (antes de ser invertida) seja 'D' para indicar um driver de exibição; os outros três bytes devem ser indicativos do nome do driver. Por exemplo, a cadeia de caracteres de marcação 'zyxD' aparecerá como 'Dxyz' se o pool for despejado. A marca aparece em qualquer despejo de memória do sistema que ocorre.

Os chamadores de VideoPortAllocatePool poderão ser executados em IRQL = DISPATCH_LEVEL somente se o PoolType solicitado for um dos tipos VpNonPagedXxx . Caso contrário, os chamadores deverão estar em execução no DISPATCH_LEVEL IRQL < .

Requisitos

Confira também

VideoPortFreePool