Metodo IDirect3DDevice9Ex::CheckDeviceState (d3d9.h)

Segnala lo stato corrente a livello cooperativo del dispositivo Direct3D per un'applicazione a schermo intero o finestra.

Sintassi

HRESULT CheckDeviceState(
  [in] HWND hDestinationWindow
);

Parametri

[in] hDestinationWindow

Tipo: HWND

Handle della finestra di destinazione per verificare la presenza di occlusione. Quando questo parametro è NULL, S_PRESENT_OCCLUDED viene restituito quando un altro dispositivo ha la proprietà a schermo intero. Quando l'handle di finestra non è NULL, l'area client della finestra viene verificata per l'occlusione. Una finestra viene occlusa se una parte di essa viene nascosta da un'altra applicazione.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono: D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED o D3DERR_OUTOFVIDEOMEMORY (vedere D3DERR) o S_PRESENT_MODE_CHANGED o S_PRESENT_OCCLUDED (vedere S_PRESENT).

Commenti

Questo metodo sostituisce IDirect3DDevice9::TestCooperativeLevel, che restituisce sempre S_OK nelle applicazioni Direct3D 9Ex.

È consigliabile non chiamare CheckDeviceState ogni frame. Chiamare invece CheckDeviceState solo se il metodo IDirect3DDevice9Ex::P resentEx restituisce un codice di errore.

Per altre informazioni su dispositivi persi, bloccati e rimossi, vedere Modifiche al comportamento del dispositivo perso.

Requisiti

Vedi anche

IDirect3DDevice9Ex