Metodo IDCompositionDevice::CheckDeviceState (dcomp.h)
Determina se l'oggetto dispositivo DirectComposition è ancora valido.
Sintassi
HRESULT CheckDeviceState(
[out] BOOL *pfValid
);
Parametri
[out] pfValid
TRUE se l'oggetto dispositivo DirectComposition è ancora valido; in caso contrario FALSE.
Valore restituito
Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .
Commenti
Se il dispositivo DXGI (Microsoft DirectX Graphics Infrastructure) viene perso, anche il dispositivo DirectComposition associato al dispositivo DXGI viene perso. Quando rileva un dispositivo perso, DirectComposition invia il messaggio WM_PAINT a tutte le finestre che compongono contenuto DirectComposition usando il dispositivo perso. Un'applicazione deve chiamare CheckDeviceState in risposta a ogni messaggio WM_PAINT per assicurarsi che l'oggetto dispositivo DirectComposition sia ancora valido. L'applicazione deve eseguire passaggi per ripristinare il contenuto se l'oggetto dispositivo non è valido. I passaggi includono la creazione di nuovi dispositivi DXGI e DirectComposition e la ricreazione di tutto il contenuto. Non è possibile creare solo un nuovo dispositivo DXGI e associarlo al dispositivo DirectComposition esistente. Il sistema garantisce che l'oggetto dispositivo rimanga valido tra WM_PAINT messaggi.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | dcomp.h |
| Libreria | Dcomp.lib |
| DLL | Dcomp.dll |