функция обратного вызова 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 |