Função VideoPortGetCommonBuffer (video.h)

A função VideoPortGetCommonBuffer está obsoleta no Windows XP e posterior e tem suporte apenas para compatibilidade com versões anteriores com drivers existentes. Em seu lugar, os gravadores de driver devem usar VideoPortAllocateCommonBuffer.

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

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN ULONG              DesiredLength,
  [in]  IN ULONG              Alignment,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [out] OUT PULONG            pActualLength,
  [in]  IN BOOLEAN            CacheEnabled
);

Parâmetros

[in] HwDeviceExtension

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

[in] DesiredLength

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

[in] Alignment

Especifica o alinhamento solicitado do buffer. O driver de porta de vídeo atualmente ignora esse parâmetro.

[out] LogicalAddress

Ponteiro para uma variável que recebe o endereço lógico a ser usado pelo adaptador para acessar o buffer alocado.

[out] pActualLength

Ponteiro para uma variável que recebe o tamanho real, em bytes, do buffer alocado para essa solicitação.

[in] CacheEnabled

Especifica se a memória alocada pode ser armazenada em cache.

Retornar valor

VideoPortGetCommonBuffer retorna o endereço virtual base do buffer alocado se tiver êxito; caso contrário, retornará NULL se o buffer não puder ser alocado.

Comentários

Consulte DMA do Mestre de Barramento em Drivers de Miniporto de Vídeo para obter informações sobre transferências de DMA baseadas em pacotes e de buffer comum.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho video.h (incluir Video.h)
Biblioteca Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Confira também

VideoPortAllocateCommonBuffer