Função VideoPortAllocateCommonBuffer (video.h)

A função VideoPortAllocateCommonBuffer aloca e mapeia a memória do sistema para que ela seja simultaneamente acessível do processador e de um dispositivo para operações de DMA de buffer comum.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN PVP_DMA_ADAPTER    VpDmaAdapter,
  [in]  IN ULONG              DesiredLength,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [in]  IN BOOLEAN            CacheEnabled,
  [out] OUT PVOID             Reserved
);

Parâmetros

[in] HwDeviceExtension

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

[in] VpDmaAdapter

Ponteiro para a estrutura VP_DMA_ADAPTER que representa o adaptador mestre do barramento. Essa estrutura foi retornada por uma chamada anterior para VideoPortGetDmaAdapter.

[in] DesiredLength

Especifica o número solicitado de bytes de memória.

[out] LogicalAddress

Ponteiro para um local de memória que recebe o endereço lógico a ser usado pelo adaptador para acessar o buffer alocado.

[in] CacheEnabled

Especifica se a memória alocada pode ser armazenada em cache. Para obter mais informações, consulte a descrição do parâmetro CacheEnabled para AllocateCommonBuffer.

[out] Reserved

No momento, é ignorado pelo driver de porta de vídeo; deve ser definido como NULL.

Valor de retorno

VideoPortAllocateCommonBuffer retorna o endereço virtual base do buffer alocado, se bem-sucedido; caso contrário, ele retornará NULL se o buffer não puder ser alocado.

Observações

Quando o buffer não for mais necessário, o driver de miniporto de vídeo deverá liberá-lo chamando VideoPortReleaseCommonBuffer.

Requisitos

Consulte também

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer