функция обратного вызова PEXECUTE_DMA (video.h)

Статья
08/07/2023

HwVidExecuteDma — это реализованная драйвером минипорта процедура обратного вызова, которая отвечает за получение пар физических адресов и длины из списка точечной и сборочной, а также за программирование оборудования для запуска фактической передачи DMA.

Синтаксис

PEXECUTE_DMA PexecuteDma;

void PexecuteDma(
  PVOID HwDeviceExtension,
  PVP_DMA_ADAPTER VpDmaAdapter,
  PVP_SCATTER_GATHER_LIST SGList,
  PVOID Context
)
{...}

Параметры

HwDeviceExtension

Указатель на область хранения для каждого адаптера драйвера мини-порта. Дополнительные сведения см. в разделе Расширения устройств.

VpDmaAdapter

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

SGList

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

Context

Указатель на определенный драйвером контекст, передаваемый из VideoPortStartDma.

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

None

Remarks

Эта функция доступна в Windows XP и более поздних версиях.

Если драйвер мини-порта сообщает, что устройство не поддерживает точечную или сборную, в этом списке будет передан только один элемент. Список точечной и собираемой информации действителен до вызова VideoPortCompleteDma .

Последняя задача, выполняемая функцией VideoPortStartDma драйвера видеопорта , заключается в вызове подпрограммы обратного вызова HwVidExecuteDma драйвера мини-порта. Именно этот обратный вызов фактически выполняет операцию передачи DMA.

HwVidExecuteDma должен находиться в непагружаемой памяти и не должен получать доступ к коду или данным, доступным для страниц.