Função VideoPortAllocateContiguousMemory (video.h)

Artigo
02/07/2025

A função VideoPortAllocateContiguousMemory é obsoleta no Windows 2000 e posterior. Os drivers de miniporto de vídeo devem usar VideoPortAllocateCommonBuffer em seu lugar.

VideoPortAllocateContiguousMemory aloca um intervalo de memória fisicamente contígua e alinhada a cache do pool nãopagado.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN ULONG            NumberOfBytes,
  [in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);

Parâmetros

[in] HwDeviceExtension

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

[in] NumberOfBytes

Especifica o tamanho em bytes do bloco de memória contígua a ser alocado.

[in] HighestAcceptableAddress

Especifica o endereço físico mais alto válido que o driver de miniporto pode usar. Por exemplo, se um dispositivo só puder fazer referência à memória física nos 16 MB inferiores, esse valor será definido como 0x00000000FFFFFF.

Valor de retorno

VideoPortAllocateContiguousMemory retornará o endereço virtual base para a memória alocada, se a chamada for bem-sucedida. Se a solicitação não puder ser atendida, NULL será retornado.

Observações

VideoPortAllocateContiguousMemory pode ser chamado para alocar um bloco contíguo de memória física para um buffer interno de longo prazo.

Um driver de miniporto que deve usar memória contígua deve alocar apenas o que precisa durante a inicialização do driver, pois o pool nãopagado provavelmente ficará fragmentado à medida que o sistema for executado. Se o driver de miniporto for descarregado, ele deverá desalocar a memória. Alocações contíguas são alinhadas em um múltiplo integral do tamanho da linha de cache de dados do processador para evitar problemas de cache e coerência.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 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	PASSIVE_LEVEL

Consulte também

VideoPortAllocateBuffer

Partilhar via