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