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

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

Синтаксис

DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;

NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}

Параметры

[in] hVidPn

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

[in] VidPnTargetId

Целое число, определяющее одну из целевых объектов видеопрезентации, связанных с объектом VidPN.

[out] phNewVidPnTargetModeSet

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

[out] ppVidPnTargetModeSetInterace

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

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN В Хвидпн указан недопустимый маркер.
STATUS_NO_MEMORY Диспетчеру VidPN не удалось выделить память, необходимую для создания нового объекта набора целевого режима.

Remarks

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

  1. Вызовите пфнкреатеневтаржетмодесет , чтобы получить маркер для нового объекта набора целевого режима. Указанный целевой режим объекта принадлежит конкретному объекту VidPN, который вы указали.
  2. Используйте функции структуры DXGK_VIDPNTARGETMODESET_INTERFACE , чтобы добавить режимы в объект набора целевого режима.
  3. Вызовите пфнассигнтаржетмодесет , чтобы назначить новый целевой режим заданному целевому объекту.
При получении маркера путем вызова пфнкреатеневтаржетмодесет и передачи этого маркера в пфнассигнтаржетмодесетвам не нужно освобождать этот обработчик путем вызова пфнрелеасетаржетмодесет.

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

Время существования структуры DXGK_VIDPNTARGETEMODESET_INTERFACE, возвращаемой в ппвидпнтаржетмодесетинтерфаце , принадлежит операционной системе. Используя эту схему владения, операционная система может переключиться на более новые реализации во время выполнения без нарушения работы клиентов интерфейса.

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

Требования

   
Минимальная версия клиента доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Рабочий стол
Header d3dkmddi. h (включение D3dkmddi. h)
УРОВЕНЬ PASSIVE_LEVEL

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

Интерфейс установки целевого режима VidPN

пфнассигнтаржетмодесет

пфнрелеасетаржетмодесет