Metodo IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Un driver basato su UMDF OnRemoteTargetQueryRemove funzione di callback degli eventi determina se un dispositivo di destinazione di I/O remoto può essere arrestato e rimosso.
Sintassi
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
Parametri
[in] pWdfRemoteTarget
Puntatore all'interfaccia di IWDFRemoteTarget di un oggetto di destinazione remoto che rappresenta una destinazione di I/O remota . Il driver ottiene questo puntatore quando chiama IWDFDevice2::CreateRemoteTarget.
Valore restituito
Se il driver determina che il dispositivo può essere arrestato e rimosso, la funzione di callback dell'evento OnRemoteTargetQueryRemove deve restituire TRUE. In caso contrario, la funzione di callback deve restituire FALSE.
Osservazioni
Se il driver fornisce un OnRemoteTargetQueryRemove funzione di callback degli eventi, la funzione di callback deve determinare se il sistema operativo deve consentire la rimozione del dispositivo. Se il driver determina che il dispositivo può essere rimosso, deve eseguire le operazioni seguenti:
- Eseguire azioni specifiche del driver necessarie per arrestare l'I/O nella destinazione remota.
- Chiamare IWDFRemoteTarget::CloseForQueryRemove.
- Restituisce TRUE per indicare che la rimozione può verificarsi.
Se il driver non fornisce questa funzione di callback, il framework chiama IWDFRemoteTarget::CloseForQueryRemove per il driver. In altre parole, il framework consente sempre la rimozione del dispositivo a meno che il driver non fornisca un OnRemoteTargetQueryRemove funzione di callback degli eventi.
Per altre informazioni sulla funzione di callback dell'evento onRemoteTargetQueryRemove , vedere Controllo dello stato di una destinazione I/O generale in UMDF.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |