Método IDirect3DDevice9Ex::CheckDeviceState (d3d9.h)

  • Artigo

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

Sintaxe

HRESULT CheckDeviceState(
  [in] HWND hDestinationWindow
);

Parâmetros

[in] hDestinationWindow

Tipo: HWND

O identificador da janela de destino para marcar para oclusão. Quando esse parâmetro é NULL, S_PRESENT_OCCLUDED é retornado quando outro dispositivo tem a propriedade de tela inteira. Quando o identificador de janela não é NULL, a área do cliente da janela é verificada quanto à oclusão. Uma janela será ocluída se qualquer parte dela for obscurecida por outro aplicativo.

Valor retornado

Tipo: HRESULT

Os valores retornados possíveis incluem: D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED ou D3DERR_OUTOFVIDEOMEMORY (consulte D3DERR) ou S_PRESENT_MODE_CHANGED ou S_PRESENT_OCCLUDED (consulte S_PRESENT).

Comentários

Esse método substitui IDirect3DDevice9::TestCooperativeLevel, que sempre retorna S_OK em aplicativos Direct3D 9Ex.

Recomendamos não chamar CheckDeviceState todos os quadros. Em vez disso, chame CheckDeviceState somente se o método IDirect3DDevice9Ex::P resentEx retornar um código de falha.

Consulte Alterações de comportamento de dispositivo perdidas para obter mais informações sobre dispositivos perdidos, suspensos e removidos.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9.h
Biblioteca D3D9.lib

Confira também

Idirect3ddevice9ex