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


функция обратного вызова 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 (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

См. также

pfnAcquireSourceModeSet

pfnCreateNewSourceModeSet