Metodo IDCompositionEffectGroup::SetTransform3D (dcomp.h)

Articolo
02/29/2024

Imposta l'oggetto effetto trasformazione 3D che modifica la rasterizzazione degli oggetti visivi a cui viene applicato questo gruppo di effetti.

Sintassi

HRESULT SetTransform3D(
  [in, optional] IDCompositionTransform3D *transform3D
);

Parametri

[in, optional] transform3D

Tipo: IDCompositionTransform3D*

Puntatore a un'interfaccia IDCompositionTransform3D o a una delle relative interfacce derivate. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

Questo metodo ha esito negativo se transform3D è un puntatore non valido o se il puntatore non è stato creato dalla stessa interfaccia IDCompositionDevice del gruppo di effetti. L'interfaccia non può essere un'implementazione personalizzata; è possibile usare solo interfacce create da Microsoft DirectComposition con questo metodo.

Se il parametro transform3D è NULL, il gruppo di effetti non applica trasformazioni di prospettiva agli oggetti visivi. L'impostazione della trasformazione su NULL equivale a impostare la trasformazione su un oggetto IDCompositionMatrixTransform3D in cui la matrice specificata è la matrice identity. Tuttavia, un'applicazione deve usare una trasformazione NULL ogni volta che è possibile perché è leggermente più veloce.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dcomp.h
Libreria	Dcomp.lib
DLL	Dcomp.dll