Metodo IDXGISwapChain2::SetMatrixTransform (dxgi1_3.h)
Imposta la matrice di trasformazione che verrà applicata a una catena di scambio di composizione al successivo presente.
A partire da Windows 8.1, le app di Windows Store possono inserire oggetti visivi della catena di scambio DirectX nelle pagine XAML usando l'elemento SwapChainPanel, che può essere posizionato e ridimensionato arbitrariamente. Questo espone gli oggetti visivi della catena di scambio DirectX agli scenari di ridimensionamento e traduzione tramite tocco dell'interfaccia utente. I metodi GetMatrixTransform e SetMatrixTransform vengono usati per sincronizzare il ridimensionamento della catena di scambio DirectX con l'elemento SwapChainPanel associato. Sono consentiti solo semplici elementi di scala/traslazione nella matrice: la chiamata avrà esito negativo se la matrice contiene elementi di rotazione/asimmetria.
Sintassi
HRESULT SetMatrixTransform(
const DXGI_MATRIX_3X2_F *pMatrix
);
Parametri
pMatrix
Matrice di trasformazione da usare per il ridimensionamento e la conversione della catena di scambio. Questa funzione può essere usata solo con catene di scambio di composizione create da IDXGIFactory2::CreateSwapChainForComposition. Nella matrice sono consentiti solo componenti di scalabilità e traslazione.
Valore restituito
SetMatrixTransform restituisce :
- S_OK se recupera correttamente la matrice di trasformazione.
- E_INVALIDARG se il parametro pMatrix non è corretto, ad esempio pMatrix è NULL o la matrice rappresentata da DXGI_MATRIX_3X2_F include componenti diversi dalla scalabilità e dalla conversione.
- DXGI_ERROR_INVALID_CALL se il metodo viene chiamato su una catena di scambio che non è stata creata con CreateSwapChainForComposition.
- Possibilmente altri codici di errore descritti nell'argomento DXGI_ERROR .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | dxgi1_3.h |
| Libreria | Dxgi.lib |