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

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

  • Статья

Функция 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, недопустим.

Комментарии

Чтобы добавить режим в набор целевых режимов, драйвер мини-порта дисплея выполняет следующие действия.

  1. Вызовите pfnCreateNewModeInfo , чтобы получить указатель на структуру D3DKMDT_VIDPN_TARGET_MODE . Функция pnfCreateNewModeInfo выделяет структуру и заполняет элемент Id только что созданным идентификатором целевого режима.
  2. Элемент Info структуры D3DKMDT_VIDPN_TARGET_MODE является D3DKMDT_VIDEO_SIGNAL_MODE структурой. Заполните структуру сведениями о режиме.
  3. Вызовите 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