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

  • Статья

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

Синтаксис

DXGKDDI_VIDPN_RELEASESOURCEMODESET DxgkddiVidpnReleasesourcemodeset;

NTSTATUS DxgkddiVidpnReleasesourcemodeset(
  [in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet
)
{...}

Параметры

[in] hVidPn

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

[in] hVidPnSourceModeSet

Дескриптор, который требуется освободить.

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

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

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

Комментарии

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

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

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

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

Требования

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

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

pfnAcquireSourceModeSet

pfnCreateNewSourceModeSet