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 |