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

  • Статья

Функция DxgkDdiControlInterrupt включает или отключает заданный тип прерывания на графическом оборудовании.

Синтаксис

DXGKDDI_CONTROLINTERRUPT DxgkddiControlinterrupt;

NTSTATUS DxgkddiControlinterrupt(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_DXGK_INTERRUPT_TYPE InterruptType,
  [in] IN_BOOLEAN EnableInterrupt
)
{...}

Параметры

[in] hAdapter

Дескриптор объекта адаптера для графического процессора (GPU). Драйвер вернул этот дескриптор в параметре MiniportDeviceContext из вызова функции DxgkDdiAddDevice .

[in] InterruptType

Значение типа DXGK_INTERRUPT_TYPE, которое предоставляет тип прерывания.

[in] EnableInterrupt

Логическое значение, указывающее, включает ли DxgkDdiControlInterrupt указанный тип прерывания. Значение TRUE указывает, что он включается, а значение FALSE указывает, что он отключается.

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

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

Код возврата Описание
STATUS_SUCCESS Тип прерывания был успешно включен или отключен на графическом оборудовании.
STATUS_NOT_IMPLEMENTED DxgkDdiControlInterrupt не поддерживает включение или отключение указанного типа прерывания.

Комментарии

Функция DxgkDdiControlInterrupt драйвера мини-порта дисплея может включать или отключать указанный тип прерывания. Однако dxgkDdiControlInterrupt не требуется отключать тип прерывания, если драйвер требует тип прерывания для внутренней цели. Вызов DxgkDdiControlInterrupt для включения указанного типа прерывания указывает, что операционная система требует, чтобы драйвер вызывал функцию DxgkCbNotifyInterrupt , чтобы сообщить, когда тип прерывания активируется на графическом оборудовании.

В настоящее время подсистема ядра графики Microsoft DirectX указывает только тип прерывания DXGK_INTERRUPT_CRTC_VSYNC в параметре InterruptType . Вызов DxgkDdiControlInterrupt для включения типа прерывания DXGK_INTERRUPT_CRTC_VSYNC указывает, что драйвер управляет прерыванием вертикального отзыва. В течение каждого периода вертикального отката и сразу после блокировки и сканирования основного адреса поверхности, указанного в регистре приложения уровня данных, следует активировать прерывание и сообщить о ней.

Драйвер должен вернуть STATUS_NOT_IMPLEMENTED, если указан тип прерывания, отличный от DXGK_INTERRUPT_CRTC_VSYNC.

DxgkDdiControlInterrupt следует сделать страничной.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h
IRQL PASSIVE_LEVEL

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

DXGK_INTERRUPT_TYPE

DxgkCbNotifyInterrupt

DxgkDdiAddDevice