Metodo Device.ValidateDevice
Aggiornamento: novembre 2007
Segnala la capacità della periferica di eseguire il rendering delle operazioni e degli argomenti di sfumatura di trama correnti in un solo passaggio.
Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Sintassi
'Dichiarazione
Public Function ValidateDevice As ValidateDeviceParams
'Utilizzo
Dim instance As Device
Dim returnValue As ValidateDeviceParams
returnValue = instance.ValidateDevice()
public ValidateDeviceParams ValidateDevice()
public:
ValidateDeviceParams ValidateDevice()
public function ValidateDevice() : ValidateDeviceParams
Valore restituito
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.ValidateDeviceParams
Oggetto ValidateDeviceParams che fornisce il numero di passaggi e il codice restituito dal controllo di convalida.
Eccezioni
| Eccezione | Condizione |
|---|---|
| DeviceLostException | La periferica è andata persa e non può essere reimpostata in questo momento; di conseguenza, non è possibile eseguire il rendering. |
| DriverInternalErrorException | Si è verificato un errore del driver interno. Quando si verifica questo errore, un'applicazione viene in genere chiusa. |
Note
Il metodo ValidateDevice deve essere utilizzato per convalidare gli scenari solo quando altre funzionalità risultano mancanti. Ad esempio, in uno scenario di trama a più scene, è possibile richiedere le proprietà MaxTextureBlendStages e MaxSimultaneousTextures per determinare se la trama a più scene è possibile sulla periferica.
L'hardware corrente non implementa necessariamente tutte le possibili combinazioni di operazioni e argomenti. Per determinare se una particolare operazione di sfumatura può essere eseguita con gli argomenti specificati, impostare l'operazione di sfumatura desiderata e chiamare il metodo ValidateDevice.
Il metodo ValidateDevice utilizza gli stati di rendering, le trame e gli stati delle scene di trama correnti per eseguire la convalida al momento della chiamata. Le modifiche a questi fattori effettuate dopo la chiamata rendono nullo il risultato precedente ed è necessario chiamare nuovamente il metodo prima di eseguire il rendering di una scena.
Per ottenere le migliori prestazioni, chiamare il metodo ValidateDevice in fase di inizializzazione; non utilizzarlo all'intermo di un ciclo di rendering.
L'utilizzo di valori interpolati diffusi, come argomento o come operazione (Diffuse, BlendDiffuseAlpha), è raramente supportato dall'hardware corrente. La maggior parte dell'hardware è in grado di introdurre dati di colore a scorrimento solo in corrispondenza dell'ultima scena di una trama.
In generale, specificare TextureColor della trama per ogni scena come primo argomento anziché come secondo argomento.
Molte schede video non supportano l'utilizzo di valori diffusi o scalari in corrispondenza di scene di trama arbitrarie. Spesso, questi valori sono disponibili solo in corrispondenza della prima o dell'ultima scena di sfumatura di trama.
Molte schede non dispongono di un'unità di sfumatura associata alla prima trama che non sia solo in grado di replicare valori alfa nei canali di colore o di invertire l'input. Di conseguenza, un'applicazione potrebbe dover utilizzare solo la seconda scena di trama, se possibile. Su hardware di questo tipo, si presuppone che la prima unità si trovi nello stato predefinito, nel quale il primo argomento di colore viene impostato su TextureColor con l'operazione SelectArg1.
Le operazioni sul valore alfa di output più complesse o sostanzialmente diverse rispetto alle operazioni di colore hanno meno probabilità di essere supportate.
Alcuni componenti hardware non supportano l'utilizzo contemporaneo di TFactor e Diffuse.
Molte schede non supportano l'utilizzo contemporaneo di più trame e filtri trilineari mipmap. Se il filtro trilineare è richiesto per una trama interessata da operazioni di sfumatura multitrama e da convalide non concesse, disattivare il filtro trilineare e ripetere la convalida. In questo caso, l'esecuzione del rendering a più passaggi potrebbe rappresentare un'alternativa migliore.
Autorizzazioni
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.
Piattaforme
Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Compact Framework
Supportato in: 3.5, 2.0