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

另请参阅

IDXGISwapChain