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

Determina se o objeto de dispositivo DirectComposition ainda é válido.

Sintaxe

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

Parâmetros

[out] pfValid

TRUE se o objeto de dispositivo DirectComposition ainda for válido; caso contrário, FALSE.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

Se o dispositivo DXGI (Infraestrutura Gráfica) do Microsoft DirectX for perdido, o dispositivo DirectComposition associado ao dispositivo DXGI também será perdido. Quando detecta um dispositivo perdido, o DirectComposition envia a mensagem WM_PAINT para todas as janelas que estão compondo o conteúdo do DirectComposition usando o dispositivo perdido. Um aplicativo deve chamar CheckDeviceState em resposta a cada mensagem WM_PAINT para garantir que o objeto de dispositivo DirectComposition ainda seja válido. O aplicativo deve tomar medidas para recuperar o conteúdo se o objeto do dispositivo se tornar inválido. As etapas incluem criar novos dispositivos DXGI e DirectComposition e recriar todo o conteúdo. (Não é possível criar apenas um novo dispositivo DXGI e associá-lo ao dispositivo DirectComposition existente.) O sistema garante que o objeto do dispositivo permaneça válido entre WM_PAINT mensagens.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dcomp.h
Biblioteca	Dcomp.lib
DLL	Dcomp.dll

Confira também

IDCompositionDevice