Compartir a través de


Método IDCompositionDevice::CheckDeviceState (dcomp.h)

Determina si el objeto de dispositivo DirectComposition sigue siendo válido.

Sintaxis

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

Parámetros

[out] pfValid

TRUE si el objeto de dispositivo DirectComposition sigue siendo válido; en caso contrario, FALSE.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

Si se pierde el dispositivo microsoft DirectX Graphics Infrastructure (DXGI), también se pierde el dispositivo DirectComposition asociado al dispositivo DXGI. Cuando detecta un dispositivo perdido, DirectComposition envía el mensaje WM_PAINT a todas las ventanas que componen el contenido de DirectComposition mediante el dispositivo perdido. Una aplicación debe llamar a CheckDeviceState en respuesta a cada mensaje de WM_PAINT para asegurarse de que el objeto de dispositivo DirectComposition sigue siendo válido. La aplicación debe realizar pasos para recuperar el contenido si el objeto de dispositivo deja de ser válido. Los pasos incluyen crear nuevos dispositivos DXGI y DirectComposition y volver a crear todo el contenido. (No es posible crear solo un nuevo dispositivo DXGI y asociarlo con el dispositivo DirectComposition existente). El sistema garantiza que el objeto de dispositivo permanezca válido entre WM_PAINT mensajes.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dcomp.h
Library Dcomp.lib
Archivo DLL Dcomp.dll

Consulte también

IDCompositionDevice