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