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

Статья
05/23/2024

Функция DxgkDdiQueryInterface возвращает функциональный интерфейс, реализованный драйвером мини-порта дисплея.

Синтаксис

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Параметры

[in] MiniportDeviceContext

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор Dxgkrnl.

[in] QueryInterface

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

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

DxgkDdiQueryInterface возвращает STATUS_SUCCESS в случае успешного выполнения; В противном случае возвращается соответствующий код NTSTATUS. Если драйвер мини-порта дисплея не поддерживает запрошенный интерфейс, он должен вернуть STATUS_NOT_SUPPORTED. Возвращая STATUS_NOT_SUPPORTED, драйвер мини-порта дисплея сообщает операционной системе, что нужно передать запрос следующему драйверу.

DxgkDdiQueryInterface предоставляет механизм взаимодействия между драйвером мини-порта дисплея и драйвером дочернего устройства (например, устройством захвата видео). Драйвер мини-порта дисплея, предоставляющий такой механизм, должен реализовывать эту функцию.

DxgkDdiQueryInterface должен заполнить элементы структуры INTERFACE, на которые указывает QueryInterface-Interface>, следующим образом:

Задайте для параметра Size значение числа байтов в структуре INTERFACE. Это значение не должно превышать число байтов, заданное параметром QueryInterface-Size>.
Задайте версию интерфейса, возвращаемого драйвером мини-порта дисплея. Драйвер мини-порта дисплея должен наилучшим образом соответствовать версии, запрошенной дочерним драйвером в QueryInterface-Version>.
Задайте параметр Контекст , чтобы указать на контекст, определенный драйвером мини-порта для интерфейса. Как правило, драйвер мини-порта дисплея задает контекст для дескриптора для блока контекста адаптера дисплея, который идентифицируется MiniportDeviceContext.
Инициализируйте InterfaceReference и InterfaceDereference , чтобы указать на реализованные драйвером минипорта для отображения подпрограммы ссылок и разыменовок для этого интерфейса.
Инициализируйте все дополнительные члены, относящиеся к интерфейсу, чтобы указать на соответствующие подпрограммы предоставляемого интерфейса.

DxgkDdiQueryInterface выполняется в IRQL = PASSIVE_LEVEL и должен быть доступен для страниц.

Требования

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

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

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

QUERY_INTERFACE

Поделиться через