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

Vedi anche

GetMatrixTransform

IDXGISwapChain2