функция обратного вызова DXGKDDI_VIDPNSOURCEMODESET_ADDMODE (d3dkmddi.h)
Функция 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 выделяет структуру, заполняет элемент идентификатором идентификатором нового исходного режима и задает для элемента 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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |