Método IDXGIFactory2::RegisterOcclusionStatusWindow (dxgi1_2.h)

  • Artigo

Registra uma janela do aplicativo para receber mensagens de notificação de alterações de status de oclusão.

Sintaxe

HRESULT RegisterOcclusionStatusWindow(
  [in]  HWND  WindowHandle,
  [in]  UINT  wMsg,
  [out] DWORD *pdwCookie
);

Parâmetros

[in] WindowHandle

O identificador da janela para a qual enviar uma mensagem de notificação quando ocorrer a oclusão status alteração.

[in] wMsg

Identifica a mensagem de notificação a ser enviada.

[out] pdwCookie

Um ponteiro para um valor de chave que um aplicativo pode passar para o método IDXGIFactory2::UnregisterOcclusionStatus para cancelar o registro da mensagem de notificação especificada por wMsg .

Retornar valor

RegisterOcclusionStatusWindow retorna:

  • S_OK se registrou com êxito a janela.
  • E_OUTOFMEMORY se a memória não estiver disponível para concluir a operação.
  • DXGI_ERROR_INVALID_CALL se WindowHandle não for um identificador de janela válido ou não o identificador de janela que o processo atual possui.
  • Possivelmente outros códigos de erro descritos no tópico DXGI_ERROR .

Atualização de plataforma para Windows 7: No Windows 7 ou Windows Server 2008 R2 com a Atualização de Plataforma para Windows 7 instalada, RegisterOcclusionStatusWindow falha com E_NOTIMPL. Para obter mais informações sobre a Atualização de Plataforma para Windows 7, consulte Atualização de plataforma para Windows 7.

Comentários

Os aplicativos escolhem a mensagem do Windows que o Windows envia quando a oclusão status é alterada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dxgi1_2.h
Biblioteca Dxgi.lib

Confira também

IDXGIFactory2