Função VideoPortAllocatePool (video.h)

Artigo
02/07/2025

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 do 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:

Valor	Significado
VpNonPagedPool	O pool é de memória nãopagada.
VpPagedPool	O pool é de memória paginada.
VpNonPagedPoolCacheAligned	O pool é da memória nãopagada alinhada ao cache.
VpPagedPoolCacheAligned	O pool é de memória paginada alinhada ao cache.

[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.

Valor de retorno

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.

Observações

VideoPortAllocatePool destina-se a substituir VideoPortAllocateBuffer, que é obsoleto.

A cadeia de caracteres de marca de 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 Marca cadeia de caracteres 'zyxD' aparece como 'Dxyz' se o pool for despejado. A marca aparece em qualquer despejo de falha do sistema que ocorre.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	video.h (inclua Video.h)
biblioteca	Videoprt.lib
de DLL	Videoprt.sys
IRQL	Consulte a seção Comentários.

Consulte também

VideoPortFreePool

Partilhar via