IDirect3D9Ex::GetAdapterDisplayModeEx 方法 (d3d9.h)
检索适配器的当前显示模式和旋转设置。
语法
HRESULT GetAdapterDisplayModeEx(
[in] UINT Adapter,
[in, out] D3DDISPLAYMODEEX *pMode,
[in, out] D3DDISPLAYROTATION *pRotation
);
参数
[in] Adapter
类型: UINT
表示要查询的显示适配器的序号。 D3DADAPTER_DEFAULT始终是主显示适配器。
[in, out] pMode
类型: D3DDISPLAYMODEEX*
指向包含有关适配器显示模式的数据的 D3DDISPLAYMODEEX 结构的指针。 与设备的显示模式相反,如果设备没有全屏模式,则设备可能不处于活动状态。 可以设置为 NULL。
[in, out] pRotation
类型: D3DDISPLAYROTATION*
指向 D3DDISPLAYROTATION 结构的指针,该结构指示应用程序将执行屏幕旋转的类型。 使用 D3DPRESENTFLAG_NOAUTOROTATE 标志时,通过此指针返回的值非常重要;否则,可以将其设置为 NULL。
返回值
类型: HRESULT
如果方法成功,则返回值D3D_OK。
如果 Adapter 在范围外或 pMode 无效,此方法将返回D3DERR_INVALIDCALL。
备注
当显示器采用扩展格式(如 2:10:10:10:10)时,GetAdapterDisplayModeEx 不会返回正确的格式。 而是返回格式 X8R8G8B8。
对窗口化应用程序,从 PresentEx 或 CheckDeviceState 返回的 S_PRESENT_MODE_CHANGED 值指示显示模式已更改,并且当前显示模式可能具有不同的格式。 为了避免颜色转换的 Present blt,窗口化应用程序可以选择使用此方法获取新的显示模式信息,并相应地调整其交换链格式。 如果此头不再是桌面的一部分或监视器断开连接,则此方法返回D3DERR_NOTAVAILABLE。
要求
目标平台 | Windows |
标头 | d3d9.h |
Library | D3D9.lib |