IWDFObject ::AssignContext, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode AssignContext inscrit un contexte et une fonction de rappel de nettoyage fournie par le pilote pour l’objet.
Syntaxe
HRESULT AssignContext(
[in, optional] __drv_aliasesMem IObjectCleanup *pCleanupCallback,
[in, optional] __drv_aliasesMem void *pContext
);
Paramètres
[in, optional] pCleanupCallback
Pointeur vers l’interface IObjectCleanup qui contient la fonction de rappel de nettoyage, qui effectue des opérations de nettoyage pour l’objet s’il devient non valide. Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne nécessite pas de notification lorsque l’objet est nettoyé.
[in, optional] pContext
Pointeur vers le contexte à inscrire. NULL est un contexte valide.
Valeur de retour
AssignContext retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Un pilote appelle AssignContext pour inscrire un contexte et demander une notification lorsque l’objet devient non valide. Dans un appel AssignContext, le pilote transmet un pointeur à l’interface IObjectCleanup dans le paramètre pCleanupCallback pour inscrire IObjectCleanup. Notez que l’infrastructure contient en interne une référence à l’interface IObjectCleanup fournie pendant que l’objet est valide. Lorsque l’objet devient non valide, l’infrastructure appelle la méthode IObjectCleanup ::OnCleanup pour notifier le pilote. L’infrastructure libère automatiquement la référence au IObjectCleanup fourni après avoir appelé IObjectCleanup ::OnCleanup.
À tout moment, un seul contexte associé à chaque instance d’objet peut exister. Les tentatives d’inscription de contextes supplémentaires échouent.
Un contexte ne peut être associé qu’à un objet qui est dans un état valide. Par exemple, une tentative d’association d’un contexte à un objet qui se trouve dans le processus de suppression échoue.
Étant donné que le contexte n’est pas une interface COM (Component Object Model), le pilote ne doit pas traiter le contexte comme tel. Par exemple, le pilote ne peut pas appeler la méthode AddRef sur le contexte.
La méthode IWDFObject ::RetrieveContext peut être utilisée pour récupérer le contexte précédemment inscrit via AssignContext.
Exemples
Pour obtenir un exemple de code montrant comment utiliser la méthode AssignContext, consultez IWDFIoTarget ::FormatRequestForWrite.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |