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

  • Artículo

Registra para recibir notificaciones de cambios en el estado de oclusión mediante la señalización de eventos.

Sintaxis

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

Parámetros

[in] hEvent

Identificador del objeto de evento que establece el sistema operativo cuando se produce la notificación del cambio de estado de oclusión. La función CreateEvent o OpenEvent devuelve este identificador.

[out] pdwCookie

Puntero a un valor de clave que una aplicación puede pasar al método IDXGIFactory2::UnregisterOcclusionStatus para anular el registro del evento de notificación que hEvent especifica.

Valor devuelto

RegisterOcclusionStatusEvent devuelve:

  • S_OK si el método registró correctamente el evento.
  • E_OUTOFMEMORY si la memoria no está disponible para completar la operación.
  • DXGI_ERROR_INVALID_CALL si hEvent no es un identificador válido o no un identificador de eventos.
  • Posiblemente otros códigos de error que se describen en el tema DXGI_ERROR .

Actualización de la plataforma para Windows 7: En Windows 7 o Windows Server 2008 R2 con la actualización de plataforma para Windows 7 instalada, RegisterOcclusionStatusEvent produce un error E_NOTIMPL. Para obtener más información sobre la actualización de plataforma para Windows 7, consulta Actualización de plataforma para Windows 7.

Comentarios

Si llama a RegisterOcclusionStatusEvent varias veces con el mismo identificador de evento, RegisterOcclusionStatusEvent produce un error DXGI_ERROR_INVALID_CALL.

Si llama a RegisterOcclusionStatusEvent varias veces con los diferentes identificadores de evento, RegisterOcclusionStatusEvent registra correctamente los eventos.

Requisitos

   
Cliente mínimo compatible Actualización de windows 8 y plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi1_2.h
Library Dxgi.lib

Consulte también

IDXGIFactory2