IDXGISwapChain::ResizeTarget 方法 (dxgi.h)
调整输出目标的大小。
语法
HRESULT ResizeTarget(
[in] const DXGI_MODE_DESC *pNewTargetParameters
);
参数
[in] pNewTargetParameters
类型: const DXGI_MODE_DESC*
指向 描述模式的DXGI_MODE_DESC 结构的指针,该模式指定目标的新宽度、高度、格式和刷新率。 如果格式DXGI_FORMAT_UNKNOWN,ResizeTarget 将使用现有格式。 我们仅建议在交换链处于全屏模式时使用 DXGI_FORMAT_UNKNOWN ,因为此方法不是线程安全的。
返回值
类型: HRESULT
返回指示成功或失败的代码。 如果在调用此 API 时发生全屏/窗口模式转换,则返回DXGI_STATUS_MODE_CHANGE_IN_PROGRESS。 有关其他 DXGI 错误代码,请参阅 DXGI_ERROR 。
注解
当交换链处于窗口模式时,ResizeTarget 会调整目标窗口的大小,并在交换链处于全屏模式时更改目标输出上的显示模式。 因此,应用可以在不知道交换链显示模式的情况下调用 ResizeTarget 来重设目标窗口 (而不是 Microsoft Win32API(如 SetWindowPos) )。
如果 Windows 应用商店应用调用 ResizeTarget,它将失败并 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE。
不能在使用 IDXGIFactory2::CreateSwapChainForComposition 创建的交换链上调用 ResizeTarget。
应用在调用 ResizeTarget 后仍必须调用 IDXGISwapChain::ResizeBuffers,因为只有 ResizeBuffers 可以更改后台缓冲区。 但是,如果这些应用已实现窗口大小处理来调用 ResizeBuffers,则它们无需在调用 ResizeTarget 后显式调用 ResizeBuffers,因为窗口大小调整处理将实现应用所需的功能。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | dxgi.h |
Library | DXGI.lib |