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

  • Статья

Функция pfnCreateNewModeInfo возвращает указатель на структуру D3DKMDT_VIDPN_SOURCE_MODE , которую драйвер мини-порта дисплея заполняет перед вызовом pfnAddMode.

Синтаксис

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Параметры

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

Указатель на переменную, которая получает указатель на D3DKMDT_VIDPN_SOURCE_MODE структуру, выделенную диспетчером VidPN.

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

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

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

Комментарии

Функция pfnCreateNewModeInfo выделяет структуру D3DKMDT_VIDPN_SOURCE_MODE , присваивает члену Id только что созданный идентификатор, а члену Type присваивается значение D3DKMDT_RMT_UNINITIALIZED.

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

  • Заполните структуру и передайте ее в pfnAddMode.
  • Освободите структуру, вызвав pfnReleaseModeInfo.
При заполнении структуры D3DKMDT_VIDPN_SOURCE_MODE можно перезаписать элемент Id , созданный и заданный pfnCreateNewModeInfo. Однако при перезаписи элемента Id любой D3DKMDT_VIDPN_SOURCE_MODE структуры необходимо перезаписать элементы Id всех D3DKMDT_VIDPN_SOURCE_MODE структур, получаемых из pfnCreateNewModeInfo. Если у вас нет определенной причины для перезаписи элементов Id (например, отслеживания режимов источника с помощью собственной схемы нумерирования), следует оставить их как заданные в pfnCreateNewModeInfo.

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

Требования

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

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

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo