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

Статья
02/07/2025

Функция 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, если буфер не может быть выделен.

Замечания

Сведения о передаче DMA на основе пакетов и общем буфере DMA см. в Bus-Master драйверах видеопорта.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	video.h (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

См. также

VideoPortAllocateCommonBuffer

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