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

Статья
08/08/2023

Функция VideoPortGetCommonBuffer устарела в Windows XP и более поздних версиях и поддерживается только для обратной совместимости с существующими драйверами. Вместо этого средства записи драйверов должны использовать VideoPortAllocateCommonBuffer.

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

Синтаксис

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

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

[in] DesiredLength

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

[in] Alignment

Указывает запрошенную выравнивание буфера. Драйвер видеопорта в настоящее время игнорирует этот параметр.

[out] LogicalAddress

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

[out] pActualLength

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

[in] CacheEnabled

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

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

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

Требования

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

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

VideoPortAllocateCommonBuffer