Функция 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 (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

См. также

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer