Metodo IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval (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 info, vedi Introduzione con UMDF.]
Una funzione di callback dell'evento OnRemoteInterfaceRemoval di un driver basato su UMDF notifica al driver che non può usare un'interfaccia di dispositivo perché l'interfaccia è stata rimossa.
Sintassi
void OnRemoteInterfaceRemoval(
[in] IWDFRemoteInterface *pWdfRemoteInterface
);
Parametri
[in] pWdfRemoteInterface
Puntatore all'interfaccia IWDFRemoteInterface di un oggetto interfaccia remota che rappresenta un'interfaccia del dispositivo. Il driver ottiene questo puntatore quando chiama IWDFDevice2::CreateRemoteInterface.
Valore restituito
nessuno
Osservazioni
La funzione di callback dell'evento OnRemoteInterfaceRemoval di un driver deve eseguire le attività specifiche del driver necessarie per gestire la rimozione dell'interfaccia del dispositivo. Inoltre, il callback deve eliminare l'oggetto interfaccia remota creato da IWDFDevice2::CreateRemoteInterface e chiamare la funzione Release dell'interfaccia se in precedenza ha chiamato la funzione AddRef dell'interfaccia.
Se il driver non fornisce questa funzione di callback, il framework elimina l'oggetto interfaccia remota creato da IWDFDevice2::CreateRemoteInterface .
Per altre informazioni sulla funzione di callback degli eventi OnRemoteInterfaceRemoval di un driver, vedere Using Device Interfaces in UMDF-based Drivers.For more information about a driver onRemoteInterfaceRemoval event callback function, see Using Device Interfaces in UMDF-based Drivers.
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) |
Vedi anche
IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival