Método IDirect3DDevice9::TestCooperativeLevel (d3d9helper.h)

Informa del estado de nivel cooperativo actual del dispositivo Direct3D para una aplicación de pantalla completa o ventana.

Sintaxis

HRESULT TestCooperativeLevel();

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK, lo que indica que el dispositivo está operativo y la aplicación que realiza la llamada puede continuar. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes valores: D3DERR_DEVICELOST, D3DERR_DEVICENOTRESET, D3DERR_DRIVERINTERNALERROR.

Comentarios

Si el dispositivo se pierde pero no se puede restaurar en la hora actual, IDirect3DDevice9::TestCooperativeLevel devuelve el código de retorno D3DERR_DEVICELOST. Este sería el caso, por ejemplo, cuando un dispositivo de pantalla completa ha perdido el foco. Si una aplicación detecta un dispositivo perdido, debe pausar y llamar periódicamente a IDirect3DDevice9::TestCooperativeLevel hasta que reciba un valor devuelto de D3DERR_DEVICENOTRESET. Después, la aplicación puede intentar restablecer el dispositivo llamando a IDirect3DDevice9::Reset y, si esto se realiza correctamente, restaure los recursos necesarios y reanude la operación normal. Tenga en cuenta que IDirect3DDevice9::P resent devolverá D3DERR_DEVICELOST si el dispositivo está "perdido" o "no restablecido".

Se producirá un error en una llamada a IDirect3DDevice9::TestCooperativeLevel si se llama a en un subproceso diferente al usado para crear el dispositivo que se está restableciendo.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d9helper.h (incluya D3D9.h)
Library	D3D9.lib

Consulte también

IDirect3DDevice9