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)

另请参阅

D3DKMDT_MONITOR_CONNECTIVITY_CHECKS

DxgkDdiCommitVidPn