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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]
Una funzione di callback dell'evento OnRemoteTargetQueryRemove basata su UMDF determina se un dispositivo di destinazione I/O remoto può essere arrestato e rimosso.
Sintassi
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
Parametri
[in] pWdfRemoteTarget
Puntatore all'interfaccia 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 evento OnRemoteTargetQueryRemove deve restituire TRUE. In caso contrario, la funzione di callback deve restituire FALSE.
Commenti
Se il driver fornisce una funzione di callback dell'evento OnRemoteTargetQueryRemove , 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 tutte le azioni specifiche del driver necessarie per arrestare l'I/O alla 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 una funzione di callback eventi OnRemoteTargetQueryRemove .
Per altre informazioni sulla funzione di callback dell'evento OnRemoteTargetQueryRemove , vedere Controllo dello stato di una destinazione di I/O generale in UMDF.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1,9 |
| Intestazione | wudfddi.h (include Wudfddi.h) |