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

Статья
05/26/2023

Функция pfnAddMode добавляет режим источника VidPN к указанному объекту набора исходного режима VidPN.

Синтаксис

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Параметры

[in] hVidPnSourceModeSet

Дескриптор для объекта набора исходного режима VidPN. Драйвер мини-порта дисплея ранее получил этот дескриптор, вызвав функцию pfnAcquireSourceModeSet интерфейса DXGK_VIDPN_INTERFACE .

[in] pVidPnSourceModeInfo

Указатель на структуру D3DKMDT_VIDPN_SOURCE_MODE , описывающую режим источника. Драйвер мини-порта дисплея ранее получил эту структуру, вызвав pfnCreateNewModeInfo.

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

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

Код возврата	Описание
STATUS_SUCCESS	Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Дескриптор, предоставленный в hVidPnSourceModeSet, был недопустимым.

Вызовите pfnCreateNewModeInfo , чтобы получить указатель на структуру D3DKMDT_VIDPN_SOURCE_MODE . Функция pnfCreateNewModeInfo выделяет структуру, заполняет элемент Id новым идентификатором исходного режима и задает элементу Typeзначение D3DKMDT_RMT_UNINITIALIZED.

Заполните структуру D3DKMDT_VIDPN_SOURCE_MODE (за исключением элемента Id ) сведениями о режиме, включая тип и формат режима.

Вызовите pfnAddMode , чтобы добавить режим в набор исходного режима.

Диспетчер VidPN выделяет структуру D3DKMDT_VIDPN_SOURCE_MODE при вызове pfnCreateNewModeInfo. При добавлении режима, описанного этой структурой, в набор исходных режимов не нужно явно освобождать структуру; pfnAddMode освобождает его.

Если вы получаете структуру D3DKMDT_VIDPN_SOURCE_MODE путем вызова pfnCreateNewModeInfo , а затем решите не добавлять этот режим в набор исходного режима, необходимо явно освободить структуру, вызвав pfnReleaseModeInfo.

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

Требования

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

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

D3DKMDT_VIDPN_SOURCE_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo

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