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

Статья
08/07/2023

DXGKCB_QUERYVIDPNINTERFACE получает указатель на структуру DXGK_VIDPN_INTERFACE , которая содержит указатели на функции, которые драйвер мини-порта дисплея может вызывать для проверки и изменения объекта VidPN.

Синтаксис

DXGKCB_QUERYVIDPNINTERFACE DxgkcbQueryvidpninterface;

NTSTATUS DxgkcbQueryvidpninterface(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_DXGK_VIDPN_INTERFACE_VERSION VidPnInterfaceVersion,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPN_INTERFACE ppVidPnInterface
)
{...}

Параметры

[in] hVidPn

Дескриптор объекта VidPN. Ранее диспетчер VidPN предоставил драйверу мини-порта дисплея с этим дескриптором, вызвав DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn или DxgkDdiRecommendFunctionalVidPn.

[in] VidPnInterfaceVersion

Перечислитель DXGK_VIDPN_INTERFACE_VERSION , указывающий версию запрашиваемого интерфейса VidPN. Вызывающие абоненты должны задать для этого параметра значение DXGK_VIDPN_INTERFACE_VERSION_V1.

[out] ppVidPnInterface

Указатель на переменную, получающую указатель на структуру DXGK_VIDPN_INTERFACE .

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_INVALID_PARAMETER	Недопустимое значение, передаваемое в ppVidPnInterface.
STATUS_GRAPHICS_INVALID_VIDPN	Дескриптор, передаваемый в hVidPn, недопустим.
STATUS_NOT_SUPPORTED	Версия интерфейса, указанная VidPnInterfaceVersion, не поддерживается.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista (WDDM 1.0)
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h (включая D3dkmddi.h)
IRQL	<= APC_LEVEL