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 管理器以前通过调用 DxgkDdiEnumVidPnCofuncModalityDxgkDdiIsSupportedVidPnDxgkDdiRecommendFunctionalVidPn,为显示微型端口驱动程序提供了此句柄。

[in] hVidPnSourceModeSet

要释放的句柄。

返回值

pfnReleaseSourceModeSet 函数返回以下值之一:

返回代码 描述
STATUS_SUCCESS 函数成功。
STATUS_GRAPHICS_INVALID_VIDPN hVidPn 中提供的句柄无效。
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET hVidPnSourceModeSet 中提供的句柄无效。
STATUS_GRAPHICS_RESOURCES_NOT_RELATED 由 hVidPn 标识的 VidPN 不包含由 hVidPnSourceModeSet 标识的源模式集。

言论

使用通过调用 pfnAcquireSourceModeSet获取的句柄后,必须通过调用 pfnReleaseSourceModeSet释放句柄。

如果通过调用 pfnCreateNewSourceModeSet 获取句柄,然后将该句柄传递给 pfnAssignSourceModeSet,则无需释放句柄。

如果通过调用 pfnCreateNewSourceModeSet 获取句柄,然后决定不将新的源模式设置为源,则必须通过调用 pfnReleaseSourceModeSet释放新获取的句柄。

D3dkmdt.h中定义了D3DKMDT_HVIDPN和D3DKMDT_HVIDPNSOURCEMODESET数据类型。

要求

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

另请参阅

pfnAcquireSourceModeSet

pfnCreateNewSourceModeSet