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

Статья
08/07/2023

Функция DxgkCbSynchronizeExecution синхронизирует указанную функцию, реализованную драйвером мини-порта дисплея, с функцией DxgkDdiInterruptRoutine драйвера дисплея miniport.

Синтаксис

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

Параметры

[in] DeviceHandle

Дескриптор, представляющий видеоадаптер. Драйвер мини-порта дисплея ранее получил этот дескриптор в элементе DeviceHandleструктуры DXGKRNL_INTERFACE , переданной в DxgkDdiStartDevice.

[in] SynchronizeRoutine

Указатель на функцию, реализованную драйвером мини-порта дисплея, которая будет синхронизирована с DxgkDdiInterruptRoutine. Функция должна соответствовать следующему прототипу:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

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

[in] MessageNumber

Номер сообщения прерывания, с которым будет синхронизироваться SynchronizeRoutine . Если прерывание основано на строке, этот параметр должен быть равен нулю.

[out] ReturnValue

Указатель на логическую переменную, которая получает возвращаемое значение SynchronizeRoutine.

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

DxgkCbSynchronizeExecution возвращает одно из следующих значений:

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_INVALID_PARAMETER	Один из параметров является недопустимым.
STATUS_UNSUCCESSFUL	Функции не удалось синхронизировать выполнение, возможно, из-за того, что прерывание еще не подключено.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	dispmprt.h (включая Dispmprt.h)
IRQL	<=DISPATCH_LEVEL

См. также раздел

DxgkDdiInterruptRoutine

KeSynchronizeExecution