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 |