Метод 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

Возвращает код, указывающий на успех или сбой. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS возвращается, если при вызове этого API происходит переход в полноэкранный или оконный режим. Дополнительные коды ошибок DXGI см. в DXGI_ERROR .

Комментарии

ResizeTarget изменяет размер целевого окна, когда цепочка буферов находится в оконном режиме, и изменяет режим отображения на целевых выходных данных, когда цепочка буферов находится в полноэкранном режиме. Поэтому приложения могут вызывать ResizeTarget для изменения размера целевого окна (а не Microsoft Win32API, например SetWindowPos), не зная режима отображения цепочки буферов.

Если приложение Магазина Windows вызывает ResizeTarget, оно завершается сбоем с DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Вы не можете вызвать ResizeTarget для цепочки буферов, созданной с помощью IDXGIFactory2::CreateSwapChainForComposition.

Приложения по-прежнему должны вызывать IDXGISwapChain::ResizeBuffers после вызова ResizeTarget , так как только ResizeBuffers могут изменять задние буферы. Но если эти приложения реализовали обработку изменения размера окна для вызова ResizeBuffers, им не нужно явно вызывать ResizeBuffers после вызова ResizeTarget , так как обработка изменения размера окна позволит достичь того, что требуется приложению.

Требования

См. также раздел

IDXGISwapChain