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

Статья
02/06/2025

Функция pfnReleaseModeInfo освобождает структуру D3DKMDT_VIDPN_SOURCE_MODE, которую ранее предоставил диспетчер VidPN драйверу мини-порта отображения.

Синтаксис

DXGKDDI_VIDPNSOURCEMODESET_RELEASEMODEINFO DxgkddiVidpnsourcemodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Параметры

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

Указатель на D3DKMDT_VIDPN_SOURCE_MODE структуру, которую необходимо освободить.

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

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

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

Замечания

Завершив использование структуры D3DKMDT_VIDPN_SOURCE_MODE, полученной путем вызова любой из следующих функций, необходимо освободить структуру, вызвав pfnReleaseModeInfo.

Если вы получите структуру D3DKMDT_VIDPN_SOURCE_MODE путем вызова pfnCreateNewModeInfo, а затем передайте эту структуру в pfnAddMode, вам не нужно освободить структуру.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

См. также

D3DKMDT_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo

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