функция обратного вызова DXGKCB_SYNCHRONIZE_EXECUTION (dispmprt.h)
Функция 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 |
Целевая платформа | Персональный компьютер |
Верхняя часть | dispmprt.h (включая Dispmprt.h) |
IRQL | <=DISPATCH_LEVEL |