Metodo ID3D11Device4::RegisterDeviceRemovedEvent (d3d11_4.h)

Registra l'evento "dispositivo rimosso" e indica quando un dispositivo Direct3D viene rimosso per qualsiasi motivo, usando un meccanismo di notifica asincrona.

Sintassi

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

Parametri

[in] hEvent

Tipo: HANDLE

Handle per l'evento "device removed".

[out] pdwCookie

Tipo: DWORD*

Puntatore alle informazioni sull'evento "dispositivo rimosso", che può essere usato in UnregisterDeviceRemoved per annullare la registrazione dell'evento.

Valore restituito

Tipo: HRESULT

Vedere Codici restituiti Direct3D 11.

Commenti

Indica quando un dispositivo Direct3D viene rimosso per qualsiasi motivo, usando un meccanismo di notifica asincrona, anziché come HRESULT da Present. Il motivo della rimozione del dispositivo può essere recuperato usando ID3D11Device::GetDeviceRemovedReason dopo la notifica dell'occorrenza.

Le applicazioni registrano e annullano la registrazione di un handle di eventi Win32 con un determinato dispositivo. Tale handle di evento verrà segnalato quando il dispositivo viene rimosso. Un polling nel metodo ID3D11Device::GetDeviceRemovedReason del dispositivo indica che il dispositivo viene rimosso.

ISignalableNotifier o SetThreadpoolWait può essere usato dalle app UWP.

Quando il dispositivo grafico viene perso, l'app o il titolo riceveranno l'evento grafico, in modo che l'app o il titolo sappiano che il dispositivo grafico non è più valido ed è sicuro che l'app o il titolo possano ricreare i dispositivi DirectX. In risposta a questo evento, l'app o il titolo devono ricreare il dispositivo di rendering e passarlo in una chiamata SetRenderingDevice sugli oggetti dispositivo grafico di composizione.

Dopo aver impostato questo nuovo dispositivo di rendering, l'app o il titolo devono ridisegnare il contenuto di tutte le superfici preesistenti dopo che viene generato l'evento OnRenderingDeviceReplaced del dispositivo grafico di composizione.

Questo metodo supporta Composition per la perdita di dispositivi.

L'evento non viene segnalato quando è più ideale ricreare. È quindi consigliabile scorrere i ordinali dell'adattatore e creare il primo ordinale ordinale che avrà esito positivo.

L'applicazione può registrare un evento con il dispositivo. L'applicazione verrà segnalata quando il dispositivo viene rimosso.

Se il dispositivo è già stato rimosso, le chiamate a RegisterDeviceRemovedEvent segnaleranno immediatamente l'evento. Nessun codice di errore rimosso dal dispositivo verrà restituito da RegisterDeviceRemovedEvent.

Ogni evento "dispositivo rimosso" non viene mai segnalato o segnalato una sola volta. Questi eventi non vengono segnalato durante la distruzione del dispositivo. Questi eventi non vengono registrati durante la distruzione.

La semantica di RegisterDeviceRemovedEvent è simile a IDXGIFactory2::RegisterOcclusionStatusEvent.

Requisiti

Vedi anche

ID3D11Device4

UnregisterDeviceRemoved