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

Статья
08/07/2023

HwVidSynchronizeExecutionCallback — это необязательная функция драйвера мини-порта, передаваемая в вызовах VideoPortSynchronizeExecution.

Синтаксис

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

Параметры

Context

Указатель на данные контекста, передаваемые в подпрограмму обратного вызова через VideoPortSynchronizeExecution. Обычно это указатель на расширение устройства или смещение в расширении устройства.

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

Если операция выполнена успешно, функция HwVidSynchronizeExecutionCallback возвращает значение TRUE.

Драйвер мини-порта с одной или несколькими функциями, которые совместно используют память с функцией HwVidInterrupt , должен иметь функцию HwVidSynchronizeExecutionCallback . Любая функция, которая совместно использует память с HwVidInterrupt , должна вызывать VideoPortSynchronizeExecution с функцией HwVidSynchronizeExecutionCallback для поддержания целостности данных в общей области памяти. То есть только одна из функций HwVidSynchronizeExecutionCallback и HwVidInterrupt может обновлять состояние в общей области в любой момент времени.

Драйвер минипорта адаптера, который не создает прерываний, также может иметь функцию HwVidSynchronizeExecutionCallback , которая будет передана в VideoPortSynchronizeExecution , когда такому драйверу необходимо выполнить некоторые критически важные работы с относительно высоким приоритетом во время выполнения. Например, совместимые с VGA драйверы мини-порта с функциями SvgaHwIoPortXxx (см. Функции SVGA) могут иметь функцию HwVidSynchronizeExecutionCallback , которая отвечает за передачу адаптеру буферизованного и проверенного приложения ввода-вывода, выдаваемого приложением.

HwVidSynchronizeExecutionCallback не должен быть доступным для страниц.