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

  • Статья

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

Синтаксис

DXGKDDI_VIDPNTARGETMODESET_RELEASEMODEINFO DxgkddiVidpntargetmodesetReleasemodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetReleasemodeinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Параметры

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Указатель на D3DKMDT_VIDPN_TARGET_MODE структуру, которая должна быть освобождена.

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Дескриптор, предоставленный в hVidPnTargetModeSet, недопустим.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET_MODE Недопустимый указатель, указанный в pVidPnTargetModeInfo.

Комментарии

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

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

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

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

Требования

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

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

D3DKMDT_VIDPN_TARGET_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo