Share via

Device.Reset (Método)

  • Artículo

Actualización: noviembre 2007

Restablece los parámetros de presentación del dispositivo actual.

Espacio de nombres:  Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado:  Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Sub Reset ( _
    presentationParameters As PresentParameters _
)
'Uso
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
)

Parámetros

Excepciones

Excepción Condición
InvalidCallException

La llamada al método no es válida. Por ejemplo, puede que un parámetro contenga un valor que no es válido.
DriverInternalErrorException

Error interno del controlador. Las aplicaciones deben, por lo general, cerrarse al recibir este error.
OutOfMemoryException

Direct3D no pudo asignar memoria suficiente para completar la llamada.

Comentarios

Al cambiar al modo de pantalla completa, Direct3D intenta encontrar un formato de escritorio que coincida con el formato del búfer de reserva de manera que los formatos de los búferes frontal y de reserva sean idénticos. De esta forma, la conversión de color no es necesaria.

Si se produce un error en una llamada a Reset, el dispositivo pasa al estado de pérdida de conexión, tal como indica el valor false devuelto de una llamada a CheckCooperativeLevel, a menos que ya se encuentre en estado de no restablecimiento, tal como indica el valor DeviceNotReset devuelto por el parámetro hResult del método CheckCooperativeLevel.

Al llamar a Reset, se pierden las superficies y la información de estado de la textura almacenadas en la memoria, y las texturas administradas se borran de la memoria de vídeo. Antes de llamar a Reset para un dispositivo, una aplicación debe liberar los destinos de representación, las superficies de estarcido de profundidad, las cadenas de intercambio adicionales, los bloques de estado y los recursos predeterminados explícitos asociados al dispositivo.

Las cadenas de intercambio son de pantalla completa o de ventana. Si la nueva cadena de intercambio es de pantalla completa, el adaptador cambia al modo de presentación que corresponda al nuevo tamaño.

Se producirá un error en una llamada a Reset si ésta se realiza en un subproceso diferente del que se utilizó para crear el dispositivo que se va a restablecer.

Se puede especificar "unknown" (desconocido) para el formato de búfer de reserva en modo de ventana al llamar a Device, Reset y SwapChain. Esto significa que la aplicación no tiene que consultar el formato actual de escritorio actual antes de llamar a Device para el modo de ventana. Para el modo de pantalla completa, debe especificarse el formato del búfer de reserva. Al establecer BackBufferCount en 0, se crea un solo búfer de reserva.

Cuando intente restablecer más de un adaptador de pantalla de un grupo, pase una matriz de objetos PresentParameters, uno para cada pantalla del grupo de adaptadores.

Permisos

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Compact Framework

Compatible con: 3.5, 2.0

Vea también

Referencia

Device (Clase)

Device (Miembros)

Microsoft.WindowsMobile.DirectX.Direct3D (Espacio de nombres)