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

  • Статья

Функция pfnReleaseTargetModeSet освобождает дескриптор целевого объекта набора режима.

Синтаксис

DXGKDDI_VIDPN_RELEASETARGETMODESET DxgkddiVidpnReleasetargetmodeset;

NTSTATUS DxgkddiVidpnReleasetargetmodeset(
  [in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet
)
{...}

Параметры

[in] hVidPn

Дескриптор объекта VidPN, который содержит объект набора целевого режима. Ранее диспетчер VidPN предоставил этот дескриптор драйверу мини-порта дисплея, вызвав DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn или DxgkDdiRecommendFunctionalVidPn.

[in] hVidPnTargetModeSet

Дескриптор, который необходимо освободить.

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN Дескриптор, предоставленный в hVidPn, был недопустим.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Дескриптор, предоставленный в hVidPnTargetModeSet, недопустим.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED VidPN, определяемый hVidPn, не содержит целевой набор режимов, определенный hVidPnTargetModeSet.

Комментарии

Завершив использование дескриптора, полученного путем вызова pfnAcquireTargetModeSet, необходимо освободить дескриптор, вызвав pfnReleaseTargetModeSet.

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

Если вы получили дескриптор путем вызова pfnCreateNewTargetModeSet , а затем решили не назначать новый исходный режим, заданный источнику, необходимо освободить только что полученный дескриптор, вызвав pfnReleaseTargetModeSet.

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

Требования

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

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

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet