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 de dispositivo do driver de miniport.
[in] VpDmaAdapter
Ponteiro para a estrutura VP_DMA_ADAPTER que representa o adaptador de master de 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 da porta de vídeo; deve ser definido como NULL.
Retornar valor
VideoPortAllocateCommonBuffer 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
Quando o buffer não for mais necessário, o driver de miniporto de vídeo deverá liberá-lo chamando VideoPortReleaseCommonBuffer.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (inclua Video.h) |
| Biblioteca | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |