Metodo Device.Reset
Aggiornamento: novembre 2007
Reimposta i parametri di presentazione della periferica corrente.
Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Sintassi
'Dichiarazione
Public Sub Reset ( _
presentationParameters As PresentParameters _
)
'Utilizzo
Dim instance As Device
Dim presentationParameters As PresentParameters
instance.Reset(presentationParameters)
public void Reset(
PresentParameters presentationParameters
)
public:
void Reset(
PresentParameters^ presentationParameters
)
public function Reset(
presentationParameters : PresentParameters
)
Parametri
presentationParameters
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.PresentParametersStruttura PresentParameters che descrive i nuovi parametri di presentazione. Questo valore non può essere null.
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidCallException | La chiamata al metodo non è valida. Un parametro potrebbe, ad esempio, contenere un valore non valido. |
| DriverInternalErrorException | Errore interno del driver. Quando si verifica questo errore, le applicazioni vengono in genere chiuse. |
| OutOfMemoryException | In Direct3D non è stata allocata una quantità di memoria sufficiente per completare la chiamata. |
Note
Quando si passa alla modalità a schermo intero, in Direct3D viene effettuato il tentativo di trovare un formato desktop corrispondente al formato del buffer nascosto in modo che i formati del buffer nascosto e del front buffer siano identici. In questo modo, viene eliminata la necessità di convertire il colore.
Se una chiamata al metodo Reset ha esito negativo, la periferica viene impostata sullo stato "perso" come indicato da un valore restituito di false da una chiamata a CheckCooperativeLevel, a meno che non si trovi già nello stato "non reimpostato" come indicato da DeviceNotReset restituito dal parametro hResult del metodo CheckCooperativeLevel.
Una chiamata al metodo Reset determina la perdita delle informazioni di stato e di tutte le superfici di memoria delle trame e la cancellazione delle trame gestite dalla memoria video. Prima di chiamare il metodo Reset per una periferica, un'applicazione deve rilasciare tutte le superfici di stencil di profondità, le catene di scambio aggiuntive, i blocchi di stato, le risorse predefinite e le destinazioni di rendering espliciti associati alla periferica.
Le catene di scambio sono a schermo intero o con finestre. Se la nuova catena di scambio è a schermo intero, l'adattatore viene impostato sulla modalità di visualizzazione che corrisponde alle nuove dimensioni.
Una chiamata a Reset ha esito negativo se effettuata su un thread diverso da quello utilizzato per creare la periferica in fase di reimpostazione.
È possibile specificare "sconosciuto" per il formato di buffer nascosto in modalità con finestre quando si chiama Device, Reset e SwapChain. Ciò significa che l'applicazione non deve interrogare il formato desktop corrente prima di chiamare Device per la modalità con finestre. Per la modalità a schermo intero, è necessario specificare il formato del buffer nascosto. Impostando la proprietà BackBufferCount su 0 viene creato un buffer nascosto.
Quando si tenta di reimpostare più di una scheda video in un gruppo, passare una matrice di oggetti PresentParameters, uno per ogni visualizzazione nel gruppo di schede.
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