IDisplayDeviceInterop：：OpenSharedHandle 方法 (windows.devices.display.core.interop.h)

打开共享主图面、共享围栏和源演示文稿句柄的句柄。

语法

HRESULT OpenSharedHandle(
  HANDLE NTHandle,
  IID    riid,
  void   **ppvObj
);

参数

NTHandle

类型： 句柄

共享主图面、共享围栏或源演示句柄的 NT 句柄。

riid

类型： REFIID

对接口标识符的引用 (IID) 以下Windows 运行时类之一的默认接口。 IID 是 GUID。

• IDisplaySurface
• IDisplayFence
• IDisplaySource

ppvObj

类型： void**

指向内存块的指针，该内存块接收指向 riid 参数指定的接口的指针。

返回值

类型： HRESULT

返回 成功时S_OK ，或描述失败时问题的失败代码。

注解

可以使用此方法打开任何共享围栏，但仅当图面创建为主图面时，才能打开它。 主表面是供显示硬件直接使用以扫描出来的表面。大多数典型的 Direct3D 图面不是作为主图面创建的，除非它们是在交换链后台缓冲区中创建的。 DisplayDevice.CreatePrimary 始终将表面创建为主图，因为它始终用于扫描。

打开源演示文稿句柄类似于为演示文稿句柄的目标调用 CreateScanoutSource，只不过不必从创建该句柄的同一 DisplayManager 创建 DisplayDevice。 这允许对扫描输出进行精细的访问控制。

要求

要求	值
最低受支持的客户端	Windows 10内部版本 20348
最低受支持的服务器	Windows 10内部版本 20348
目标平台	Windows
标头	windows.devices.display.core.interop.h
Library	d3d12.lib
DLL	d3d12.dll

另请参阅

• CreateSharedHandle