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


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

Функция 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 (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

D3DKMDT_VIDPN_SOURCE_MODE

pfnAcquireFirstModeInfo

pfnAcquireNextModeInfo

pfnAcquirePinnedModeInfo