Метод IDCompositionDevice::CheckDeviceState (dcomp.h)
Определяет, действителен ли объект устройства DirectComposition.
Синтаксис
HRESULT CheckDeviceState(
[out] BOOL *pfValid
);
Параметры
[out] pfValid
ЗНАЧЕНИЕ TRUE, если объект устройства DirectComposition по-прежнему действителен; В противном случае — FALSE.
Возвращаемое значение
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
При потере устройства Microsoft DirectX Graphics Infrastructure (DXGI) также теряется устройство DirectComposition, связанное с устройством DXGI. При обнаружении потерянного устройства DirectComposition отправляет сообщение WM_PAINT всем окнам, которые составляют содержимое DirectComposition с использованием потерянного устройства. Приложение должно вызывать CheckDeviceState в ответ на каждое сообщение WM_PAINT , чтобы убедиться, что объект устройства DirectComposition по-прежнему действителен. Приложение должно выполнить действия по восстановлению содержимого, если объект устройства становится недопустимым. Шаги включают создание новых устройств DXGI и DirectComposition и повторное создание всего содержимого. (Невозможно создать только новое устройство DXGI и связать его с существующим устройством DirectComposition.) Система гарантирует, что объект устройства остается действительным между WM_PAINT сообщений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |