Função VideoPortGetCommonBuffer (video.h)
A função VideoPortGetCommonBuffer é 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 simultaneamente acessível 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 do 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.
Valor de retorno
VideoPortGetCommonBuffer retorna o endereço virtual base do buffer alocado se bem-sucedido; caso contrário, retornará NULL se o buffer não puder ser alocado.
Observações
Consulte Bus-Master DMA 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 |
|---|---|
| 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 |