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

  • Artigo

Relata o status de nível cooperativo atual do dispositivo Direct3D para um aplicativo em janelas ou em tela inteira.

Sintaxe

HRESULT TestCooperativeLevel();

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK, indicando que o dispositivo está operacional e o aplicativo de chamada pode continuar. Se o método falhar, o valor retornado poderá ser um dos seguintes valores: D3DERR_DEVICELOST, D3DERR_DEVICENOTRESET D3DERR_DRIVERINTERNALERROR.

Comentários

Se o dispositivo for perdido, mas não puder ser restaurado no momento atual, IDirect3DDevice9::TestCooperativeLevel retornará o código de retorno D3DERR_DEVICELOST. Esse seria o caso, por exemplo, quando um dispositivo de tela inteira perdeu o foco. Se um aplicativo detectar um dispositivo perdido, ele deverá pausar e chamar periodicamente IDirect3DDevice9::TestCooperativeLevel até receber um valor retornado de D3DERR_DEVICENOTRESET. Em seguida, o aplicativo pode tentar redefinir o dispositivo chamando IDirect3DDevice9::Reset e, se isso for bem-sucedido, restaurar os recursos necessários e retomar a operação normal. Observe que IDirect3DDevice9::P resent retornará D3DERR_DEVICELOST se o dispositivo estiver "perdido" ou "não redefinido".

Uma chamada para IDirect3DDevice9::TestCooperativeLevel falhará se for chamada em um thread diferente daquele usado para criar o dispositivo que está sendo redefinido.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9