Метод IDXGISwapChain2::SetMatrixTransform (dxgi1_3.h)

  • Статья

Задает матрицу преобразования, которая будет применена к цепочке буферов композиции при следующем представлении.

Начиная с Windows 8.1, приложения Магазина Windows могут размещать визуальные элементы цепочки буферов DirectX на xaml-страницах с помощью элемента SwapChainPanel, который можно разместить произвольно и по размеру. Это позволяет использовать визуальные элементы цепочки буферов DirectX для сценариев сенсорного масштабирования и перевода с помощью сенсорного пользовательского интерфейса. Методы GetMatrixTransform и SetMatrixTransform используются для синхронизации масштабирования цепочки буферов DirectX с соответствующим элементом SwapChainPanel . В матрице разрешены только простые элементы масштабирования и преобразования. Вызов завершится ошибкой, если матрица содержит элементы отклонения или поворота.

Синтаксис

HRESULT SetMatrixTransform(
  const DXGI_MATRIX_3X2_F *pMatrix
);

Параметры

pMatrix

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

Возвращаемое значение

SetMatrixTransform возвращает:

  • S_OK, если матрица преобразования успешно извлекается.
  • E_INVALIDARG, если параметр pMatrix неверен, например, pMatrix имеет значение NULL или матрица, представленная DXGI_MATRIX_3X2_F включает компоненты, отличные от масштабирования и преобразования.
  • DXGI_ERROR_INVALID_CALL, если метод вызывается в цепочке буферов, созданной не с помощью CreateSwapChainForComposition.
  • Возможно, другие коды ошибок, описанные в DXGI_ERROR разделе.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dxgi1_3.h
Библиотека Dxgi.lib

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

GetMatrixTransform

IDXGISwapChain2