DXGKDDI_VIDPN_ACQUIRETARGETMODESET回调函数 （d3dkmddi.h）
pfnAcquireTargetModeSet 函数将句柄返回到指定的 VidPN 对象包含的特定目标模式集对象。
语法
DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;
NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}
参数
[in] hVidPn
VidPN 对象的句柄。 VidPN 管理器以前通过调用 DxgkDdiEnumVidPnCofuncModality、DxgkDdiIsSupportedVidPn或 DxgkDdiRecommendFunctionalVidPn，为显示微型端口驱动程序提供了此句柄。
[in] VidPnTargetId
一个整数，用于标识与 VidPN 对象关联的视频演示目标之一。
[out] phVidPnTargetModeSet
指向接收所请求目标模式集对象的句柄的变量的指针。
[out] ppVidPnTargetModeSetInterface
指向接收指向 DXGK_VIDPNTARGETMODESET_INTERFACE 结构的指针的变量的指针。 该结构包含指向显示微型端口驱动程序可以调用以检查和更改目标模式集对象的函数的指针。
返回值
pfnAcquireTargetModeSet 函数返回以下值之一：
| 返回代码 | 描述 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| STATUS_GRAPHICS_INVALID_VIDPN | hVidPn 中提供的句柄无效。 |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | VidPnTargetId 中提供的标识符无效。 |
言论
显示微型端口驱动程序分配 VidPN 目标标识符。 DxgkDdiQueryChildRelations（由显示微型端口驱动程序实现）返回 DXGK_CHILD_DESCRIPTOR 结构的数组，每个结构都包含标识符。
使用完目标模式集对象句柄后，必须通过调用 pfnReleaseTargetModeSet释放句柄。 目标模式集对象被引用计数，因此，如果获取句柄多次，则必须释放该句柄的次数相同。
ppVidPnTargetModeSetInterface 中返回的 DXGK_VIDPNTARGETMODESET_INTERFACE 结构的生存期由作系统所有。 使用此所有权方案，作系统可以在运行时切换到较新的实现，而不会中断接口的客户端。
D3DDDI_VIDEO_PRESENT_TARGET_ID数据类型在 D3dukmdt.h中定义。
D3DKMDT_HVIDPN和D3DKMDT_HVIDPNTARGETMODESET数据类型在 D3dkmdt.h中定义。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |