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

  • Статья

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

Синтаксис

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Параметры

[in] hVidPn

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

[in] VidPnSourceId

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

[out] phVidPnSourceModeSet

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

[out] ppVidPnSourceModeSetInterface

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

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

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

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

Комментарии

Идентификаторы источника VidPN назначаются операционной системой. DxgkDdiStartDevice, реализованный драйвером мини-порта дисплея, возвращает число N источников видеотрансляции, поддерживаемых видеоадаптером. Затем операционная система назначает идентификаторы 0, 1, 2, ... N - 1.

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

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

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

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

Требования

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

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

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

pfnAssignTargetModeSet

pfnCreateNewSourceModeSet

pfnReleaseTargetModeSet