Metodo IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)

Articolo
03/05/2024

[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 determina che il dispositivo non deve essere rimosso, la funzione di callback deve restituire FALSE. In genere, i driver devono evitare di restituire FALSE, perché un valore restituito FALSE può causare il riavvio di Windows.

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)

Vedi anche

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete

Condividi tramite