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

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

Синтаксис

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

Параметры

[in] hVidPn

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

[in] VidPnTargetId

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

[out] phVidPnTargetModeSet

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

[out] ppVidPnTargetModeSetInterface

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

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN	Дескриптор, предоставленный в hVidPn, был недопустимым.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Недопустимый идентификатор, указанный в VidPnTargetId.

Комментарии

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

Завершив использование дескриптора объекта в целевом режиме, необходимо освободить дескриптор, вызвав pfnReleaseTargetModeSet. Объекты набора целевого режима считаются ссылками, поэтому при получении дескриптора несколько раз его необходимо освободить столько же раз.

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

Тип данных D3DDDI_VIDEO_PRESENT_TARGET_ID определен в D3dukmdt.h.

Типы данных D3DKMDT_HVIDPN и D3DKMDT_HVIDPNTARGETMODESET определяются в D3dkmdt.h.

Требования

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

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

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

pfnAssignTargetModeSet

pfnCreateNewTargetModeSet

pfnReleaseTargetModeSet