DXGKARG_COMMITVIDPN 结构 (d3dkmddi.h)
DXGKARG_COMMITVIDPN 结构包含 DxgkDdiCommitVidPn 函数的参数。
语法
typedef struct _DXGKARG_COMMITVIDPN {
IN D3DKMDT_HVIDPN hFunctionalVidPn;
IN D3DDDI_VIDEO_PRESENT_SOURCE_ID AffectedVidPnSourceId;
IN D3DKMDT_MONITOR_CONNECTIVITY_CHECKS MonitorConnectivityChecks;
IN HANDLE hPrimaryAllocation;
[in] IN DXGKARG_COMMITVIDPN_FLAGS Flags;
} DXGKARG_COMMITVIDPN;
成员
hFunctionalVidPn
将在显示适配器上激活的功能 VidPN 对象的句柄。
AffectedVidPnSourceId
VidPN 中特定视频当前源的常量D3DDDI_ID_ALL或标识符：
- 如果此成员是源标识符， DxgkDdiCommitVidPn 仅更新源自该源的视频呈现路径的模式。 DxgkDdiCommitVidPn 不需要检查源自其他源的路径，因为这些路径在新 VidPN 中与当前处于活动状态的 VidPN 中的路径相同。
- 如果此成员等于 D3DDDI_ID_ALL，DxgkDdiCommitVidPn 必须检查整个 VidPN 并将其更新为单个事务;也就是说，整个新 VidPN 必须处于活动状态，或者整个当前 VidPN 必须保持活动状态。
MonitorConnectivityChecks
D3DKMDT_MONITOR_CONNECTIVITY_CHECKS 枚举器 (D3DKMDT_MCC_IGNORE或D3DKMDT_MCC_ENFORCE) ，指定是否验证新拓扑中的视频输出是否已连接监视器：
- 如果此成员等于 D3DKMDT_MCC_ENFORCE 并且新 VidPN 拓扑中的某个视频输出未连接监视器， 则 DxgkDdiCommitVidPn 必须保留当前处于活动状态的 VidPN 并返回STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY。
- 如果此成员等于 D3DKMDT_MCC_IGNORE，DxgkDdiCommitVidPn 可以激活新的 VidPN，而无需检查是否连接了任何视频输出的监视器。
hPrimaryAllocation
与 AffectedVidPnSourceId 标识的视频当前源关联的主分配的句柄。
[in] Flags
一个 DXGKARG_COMMITVIDPN_FLAGS 结构，用于标识有关对 DxgkDdiCommitVidPn 函数的调用的详细信息。
注解
D3DDDI_ID_ALL常量在 D3dukmddi.h 中定义。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |