Share via

IDirect3D9ExOverlayExtension：：CheckDeviceOverlayType 方法 (d3d9.h)

  • 项目

查询 Direct3D 设备的覆盖硬件功能。

语法

HRESULT CheckDeviceOverlayType(
  [in]  UINT               Adapter,
  [in]  D3DDEVTYPE         DevType,
  [in]  UINT               OverlayWidth,
  [in]  UINT               OverlayHeight,
  [in]  D3DFORMAT          OverlayFormat,
  [in]  D3DDISPLAYMODEEX   *pDisplayMode,
  [in]  D3DDISPLAYROTATION DisplayRotation,
  [out] D3DOVERLAYCAPS     *pOverlayCaps
);

参数

[in] Adapter

表示显示适配器的序号。 D3DADAPTER_DEFAULT 始终是主要显示适配器。

[in] DevType

将 Direct3D 设备类型指定为 D3DDEVTYPE 枚举类型的成员。

[in] OverlayWidth

要创建的覆盖层的宽度（以像素为单位）。

[in] OverlayHeight

要创建的覆盖层的高度（以像素为单位）。

[in] OverlayFormat

覆盖图面格式。

[in] pDisplayMode

指向 D3DDISPLAYMODEEX 结构的指针，该结构指定将使用的显示模式。 如果此参数为 NULL，则假定为当前显示模式。

[in] DisplayRotation

将显示旋转模式指定为 D3DDISPLAYROTATION 枚举类型的成员。

[out] pOverlayCaps

指向 D3DOVERLAYCAPS 结构的指针。 如果驱动程序支持输入参数中指定的覆盖设置，则 方法会用覆盖硬件的功能填充此结构。

返回值

此方法可以返回其中一个值。

返回代码 说明
D3DERR_INVALIDCALL
 参数无效，或设备不支持硬件覆盖。
D3DERR_UNSUPPORTEDOVERLAY
 设备不支持覆盖指定大小或显示模式。
D3DERR_UNSUPPORTEDOVERLAYFORMAT
 设备不支持对指定图面格式进行覆盖。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 d3d9.h

另请参阅

硬件覆盖支持

IDirect3D9ExOverlayExtension