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

Статья
06/10/2023

Функция pfnGetAdditionalMonitorModeSet возвращает дескриптор дополнительному объекту набора исходного режима монитора, связанному с указанным монитором. Он доступен в интерфейсе DXGK_MONITOR_INTERFACE_V2 , начиная с Windows 7.

Синтаксис

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Параметры

[in] hAdapter

Дескриптор, идентифицирующий видеоадаптер. Подсистема графического ядра Microsoft DirectX ранее предоставляла этот дескриптор драйверу мини-порта для отображения в параметре DxgkInterface функции DxgkDdiStartDevice .

[in] VideoPresentTargetId

Целое число, идентифицирующее один из целевых объектов видео на видеоадаптере. Возвращаемый объект ppAdditionalModesSet с дополнительными режимами описывает дополнительные наборы исходных режимов монитора, доступные на мониторе, подключенном к данному целевому объекту видео.

[out] pNumberModes

Указатель на переменную, содержащую количество дополнительных режимов времени для целевого объекта представления видео, заданного VideoPresentTargetId.

[out] ppAdditionalModesSet

Указатель на переменную, получающую указатель на DXGK_TARGETMODE_DETAIL_TIMING структуру. Структура описывает дополнительные режимы времени целевого объекта видео, совместимые с устройством отображения.

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

Функция pfnAcquireMonitorSourceModeSet возвращает одно из следующих значений.

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	Дескриптор, предоставленный в hAdapter, был недопустимым.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Идентификатор, предоставленный в VideoPresentTargetId, был недопустимым.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Нет монитора, подключенного к целевому объекту видеотрансляций, определенному с помощью VideoPresentTargetId.
STATUS_NOT_FOUND	Не удалось найти целевой объект для представления видео, определенный VideoPresentTargetId.

Целевые идентификаторы VidPN назначаются драйвером мини-порта дисплея. Функция DxgkDdiQueryChildRelations , реализованная драйвером мини-порта дисплея, возвращает массив DXGK_CHILD_DESCRIPTOR структур, каждая из которых содержит идентификатор.

Эта функция доступна начиная с Windows 7.

Требования

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