IPnpCallback ::OnSurpriseRemoval, méthode (wudfddi.h)

Article
03/01/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode OnSurpriseRemoval avertit un pilote après la suppression inattendue d’un appareil d’un ordinateur afin que le pilote puisse effectuer les opérations nécessaires.

Syntaxe

void OnSurpriseRemoval(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour l’objet d’appareil de l’appareil qui est supprimé de manière inattendue.

Valeur de retour

None

Remarques

Un pilote inscrit l’interface IPnpCallback quand le pilote appelle la méthode IWDFDriver ::CreateDevice pour créer un objet de périphérique.

L’infrastructure ne synchronise pas la fonction de rappel OnSurpriseRemoval avec d’autres fonctions de rappel PnP et de gestion de l’alimentation.

Pour plus d’informations sur le moment où l’infrastructure appelle cette fonction de rappel et pour plus d’informations sur les problèmes de synchronisation, consultez Un utilisateur débranche un appareil.