Поделиться через


Функция VideoPortAllocateCommonBuffer (video.h)

Функция VideoPortAllocateCommonBuffer выделяет и сопоставляет системную память, чтобы она была одновременно доступна как из процессора, так и из устройства для операций DMA с общим буфером.

Синтаксис

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

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

[in] VpDmaAdapter

Указатель на структуру VP_DMA_ADAPTER, представляющую адаптер master шины. Эта структура была возвращена при предыдущем вызове VideoPortGetDmaAdapter.

[in] DesiredLength

Указывает запрошенный объем памяти в байтах.

[out] LogicalAddress

Указатель на расположение памяти, которое получает логический адрес, используемый адаптером для доступа к выделенному буферу.

[in] CacheEnabled

Указывает, можно ли кэшировать выделенную память. Дополнительные сведения см. в описании параметра CacheEnabled для AllocateCommonBuffer.

[out] Reserved

В настоящее время игнорируется драйвером видеопорта; для параметра должно быть задано значение NULL.

Возвращаемое значение

VideoPortAllocateCommonBuffer возвращает базовый виртуальный адрес выделенного буфера в случае успешного выполнения. В противном случае возвращается значение NULL , если буфер не может быть выделен.

Комментарии

Если буфер больше не нужен, драйвер видео минипорта должен освободить его, вызвав VideoPortReleaseCommonBuffer.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включая Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

См. также раздел

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer