Condividi tramite


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

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceevent

IRemoteInterfaceCallbackRemoval