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 由 hVidPn 标识的 VidPN 不包含由 hVidPnTargetModeSet 标识的目标模式集。

注解

使用完通过调用 pfnAcquireTargetModeSet 获取的句柄后，必须通过调用 pfnReleaseTargetModeSet 释放句柄。

如果通过调用 pfnCreateNewTargetModeSet 获取句柄，然后将该句柄传递给 pfnAssignTargetModeSet，则无需释放句柄。

如果通过调用 pfnCreateNewTargetModeSet 获取句柄，然后决定不将新的源模式集分配给源，则必须通过调用 pfnReleaseTargetModeSet 释放新获取的句柄。

D3DKMDT_HVIDPN和D3DKMDT_HVIDPNTARGETMODESET数据类型在 D3dkmdt.h 中定义。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另请参阅

pfnAcquireTargetModeSet

pfnCreateNewTargetModeSet