Método ID3D11Device4::RegisterDeviceRemovedEvent (d3d11_4.h)

  • Artículo

Registra el evento "dispositivo quitado" e indica cuándo se ha quitado un dispositivo Direct3D por cualquier motivo, mediante un mecanismo de notificación asincrónico.

Sintaxis

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

Parámetros

[in] hEvent

Tipo: HANDLE

Identificador del evento "dispositivo quitado".

[out] pdwCookie

Tipo: DWORD*

Puntero a información sobre el evento "device removed", que se puede usar en UnregisterDeviceRemoved para anular el registro del evento.

Valor devuelto

Tipo: HRESULT

Consulta Códigos de retorno de Direct3D 11.

Comentarios

Indica cuándo se ha quitado un dispositivo Direct3D por cualquier motivo, mediante un mecanismo de notificación asincrónico, en lugar de como HRESULT de Present. El motivo de la eliminación del dispositivo se puede recuperar mediante ID3D11Device::GetDeviceRemovedReason después de recibir una notificación de la repetición.

Las aplicaciones registran y anulan el registro de un identificador de eventos Win32 con un dispositivo determinado. Ese identificador de eventos se indicará cuando se quite el dispositivo. Un sondeo en el método ID3D11Device::GetDeviceRemovedReason del dispositivo indica que se quita el dispositivo.

Las aplicaciones para UWP pueden usar ISignalableNotifier o SetThreadpoolWait.

Cuando se pierde el dispositivo gráfico, la aplicación o el título recibirán el evento de gráficos, de modo que la aplicación o el título sepan que su dispositivo gráfico ya no es válido y es seguro para que la aplicación o el título vuelvan a crear sus dispositivos DirectX. En respuesta a este evento, la aplicación o el título deben volver a crear su dispositivo de representación y pasarlo a una llamada SetRenderingDevice en los objetos de dispositivo de gráficos de composición.

Después de establecer este nuevo dispositivo de representación, la aplicación o el título deben volver a dibujar el contenido de todas las superficies preexistentes después de que se desencadene el evento OnRenderingDeviceReplaced del dispositivo gráfico de composición.

Este método admite Composition para la pérdida de dispositivos.

El evento no se señala cuando es más ideal para volver a crear. Por lo tanto, en su lugar, se recomienda recorrer en iteración los ordinales del adaptador y crear el primer ordinal que se realizará correctamente.

La aplicación puede registrar un evento con el dispositivo. La aplicación se indicará cuando se quite el dispositivo.

Si el dispositivo ya se ha quitado, las llamadas a RegisterDeviceRemovedEvent indicarán el evento inmediatamente. No se devolverá ningún código de error quitado del dispositivo desde RegisterDeviceRemovedEvent.

Cada evento "dispositivo quitado" nunca se señala o se señala solo una vez. Estos eventos no se indican durante la destrucción del dispositivo. Estos eventos no se registran durante la destrucción.

La semántica de RegisterDeviceRemovedEvent es similar a IDXGIFactory2::RegisterOcclusionStatusEvent.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d11_4.h
Library D3d11.lib

Consulte también

ID3D11Device4

UnregisterDeviceRemoved