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

Статья
04/18/2024

Функция pfnAddMode добавляет целевой режим VidPN к указанному объекту набора целевого режима VidPN.

Синтаксис

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Параметры

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Указатель на структуру D3DKMDT_VIDPN_TARGET_MODE , описывающую целевой режим. Драйвер мини-порта дисплея ранее получил эту структуру, вызвав pfnCreateNewModeInfo.

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	Дескриптор, предоставленный в hVidPnTargetModeSet, недопустим.

Вызовите pfnCreateNewModeInfo , чтобы получить указатель на структуру D3DKMDT_VIDPN_TARGET_MODE . Функция pnfCreateNewModeInfo выделяет структуру и заполняет элемент Id только что созданным идентификатором целевого режима.
Элемент Info структуры D3DKMDT_VIDPN_TARGET_MODE является D3DKMDT_VIDEO_SIGNAL_MODE структурой. Заполните структуру сведениями о режиме.
Вызовите pfnAddMode , чтобы добавить режим в набор целевых режимов.

Диспетчер VidPN выделяет структуру D3DKMDT_VIDPN_TARGET_MODE при вызове pfnCreateNewModeInfo. При добавлении режима, описанного этой структурой, в целевой набор режимов не нужно явно освобождать структуру; pfnAddMode освобождает его.

Если вы получили D3DKMDT_VIDPN_TARGET_MODE структуру, вызвав pfnCreateNewModeInfo , а затем решили не добавлять этот режим в набор целевых режимов, необходимо явно освободить структуру, вызвав pfnReleaseModeInfo.

Тип данных D3DKMDT_HVIDPNTARGETMODESET определен в D3dkmdt.h.

Требования

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

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

D3DKMDT_VIDPN_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo

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