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

Registra-se para receber notificação de alterações no status de oclusão usando a sinalização de evento.

Sintaxe

HRESULT RegisterOcclusionStatusEvent(
  [in]  HANDLE hEvent,
  [out] DWORD  *pdwCookie
);

Parâmetros

[in] hEvent

Um identificador para o objeto de evento que o sistema operacional define quando ocorre a notificação de oclusão status alteração. A função CreateEvent ou OpenEvent retorna esse identificador.

[out] pdwCookie

Um ponteiro para um valor de chave que um aplicativo pode passar para o método IDXGIFactory2::UnregisterOcclusionStatus para cancelar o registro do evento de notificação especificado por hEvent .

Valor retornado

RegisterOcclusionStatusEvent retorna:

• S_OK se o método registrou com êxito o evento.
• E_OUTOFMEMORY se a memória não estiver disponível para concluir a operação.
• DXGI_ERROR_INVALID_CALL se hEvent não for um identificador válido ou não for um identificador de evento.
• 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, RegisterOcclusionStatusEvent 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

Se você chamar RegisterOcclusionStatusEvent várias vezes com o mesmo identificador de evento, RegisterOcclusionStatusEvent falhará com DXGI_ERROR_INVALID_CALL.

Se você chamar RegisterOcclusionStatusEvent várias vezes com os diferentes identificadores de evento, RegisterOcclusionStatusEvent registrará corretamente os eventos.

Requisitos

Confira também

IDXGIFactory2