Функция 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 |